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INTRODUCTION 



1 . WHAT IS NEWSCOOP? 

2. FEATURE LIST 



I. 



WHAT IS NEWSCOOP? 



Newscoop is a multi-lingual enterprise content management system for on-line newspapers 
and magazines, enabling scheduled publishing of multimedia. Built-in revenue generation 
features include support for paid or trial reader subscriptions, and geolocation-based 
services. 

The administration interface is built with the journalist, editor and publisher in mind, based 
on feedback from the news organizations around the world that have deployed 
Sourcefabric's newsroom software since the launch of the first version in I 999. 

Newscoop follows a print publishing model, so it structures websites as Publications, Issues, 
Sections and Articles by default. Newscoop was designed for medium-to-large online 
publications, but it is capable of handling nimbler sites too. 
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With Newscoop, you can edit articles using an advanced WYSIWYG interface, and manage 
articles translated into different languages. A traditional editorial process ensures quality of 
content: the journalist writes the article, the editor reviews the content, and then the article 
can be published. The Newscoop administration interface works in most modern web 
browsers, including Mozilla Firefox and Microsoft Internet Explorer. No browser plug-ins 
are necessary. 
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You can also create your own definition of what a particular type of article should include. 
For example, one article type might consist of "Intro", "Body", and "References", while 
another type might include only "Body" and "Author Bio". You can incorporate images, 
audio and video into your articles, for delivery directly in the browser window or as 
attachments for download. Articles can be categorized with topics, and scheduled for 
release at a future date, or published immediately. 

Newscoop offers full control over the look and feel of your web site via a flexible HTML5 
and CSS3 ready template engine. The PHP object-oriented API enables your website 
developers to build third-party plug-ins too. Built-in support for translation allows the 
administration interface to be adapted to support new languages quickly and easily. 

Managers will appreciate the fine-grained access control for different types of staff users, 
including journalists, editors, and subscription managers. The integrated subscription 
features include IP-based access control for corporate and institutional accounts. 

Newscoop is Open Source software released by Sourcefabric under the GNU General 
Public License. It incorporates the TinyMCE WYSIWYG text editor and Plupload file 
handler from Moxiecode Systems AB, Christophe Dolivet's EditArea as a template editor, 
and PhotoViewer by Joseph Nicora for thumbnail zooming. Geographical data is provided by 
GeoNames. 
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FEATURE LIST 



This list of features is provided as a guide to help you decide if Newscoop is the right 
content management system for your publication. 

MULTI-LINGUAL CONTENT 

All of the content that you create in Newscoop can be translated: 

• Articles 

• Sections 

• Issues 

• Publications 

• Topics (content categorization) 

• File attachment descriptions 

The Newscoop administration interface has been translated into the following languages (in 
alphabetical order): 

1 . Arabic 

2. Belarusian 

3. Chinese (Simplified) 

4. Chinese (Traditional) 

5. Croatian 

6. Czech 

7. Dutch 

8. English 

9. French 
10. Georgian 
I I . German 

I 2. Korean 

13. Polish 

14. Portuguese 

1 5. Romanian 

16. Russian 

1 7. Serbian (Cyrillic) 

18. Serbo-Croatian (Latin) 

19. Spanish 

20. Swedish 

Further translations can be added using a tool built into Newscoop called the "Localizer". 

REVENUE GENERATION 

1 . Control access to your content via: 

o User's IP Address (for corporate accounts) 
o Login/password (for individual users) 

2. Control the content your subscribers have access to: 

o The entire issue 

o Specific sections in each issue 

o Specific sections in a particular language 



3. Support for a trial subscription period, for instant access while payment is made 

4. Set your own pay periods (the time between each payment made by a subscriber) 

5. Geolocation and mapping features, enabling location-based services 

EDITORIAL FEATURES 

1 . Online WYSIWYG editor for article editing: 

o Typical style formatting: bold, italic, etc. 

o Special support for linking to existing (internal) articles 

o Ability to split articles into multiple pages 

o Insert images into your articles 

o Copy & Paste clean text from Microsoft Word or OpenOffice.org (while 

preserving bold and italics) 
o Insert subtitles, which can be used for breaking up the article (pagination) 

2. Built with multiple simultaneous users in mind 

o While a journalist is editing an article, it is "locked". A warning will be displayed 
if anyone else tries to edit the article at the same time. This prevents one 
journalist from deleting the work of another 

3. Group articles into sections 

4. Group sections into an issue 

5. Release an issue all at once 

6. Allow subscribers to access only certain issues 

7. Scheduled PublisKiing: automatically publish articles or issues at some time in the 
future. For articles, you can schedule the following actions: 

o publish 

o unpublish 

o show the article on the front page 

o remove the article from front page 

o show the article on the section page 

o remove the article from the section page 

8. Topics: Categorize your content 

o Define however many topics you like 

o Associate any number of topics to an article 

o Topic can have subtopics, subtopics can have sub-subtopics, etc. 

o Topics can be translated 

9. Dynamic, Flexible Article Types 

o "Article Types" allow you to define your own article format - you aren't limited 
to just "Introduction" and "Body" fields, for instance. An Article Type consists 
of a series of data fields 

o You can define any number and combination of the following field types: 

■ date field 

■ single-line text field 

■ multiple-line text field with WYSIWYG editor 

■ drop-down selection containing a list of topics 

o Reorder how the fields are displayed in the admin interface 

o Hide fields that are no longer in use 

o Translate the field names 

o Change the data type for afield 
1 0. Image Manager 

o View/search all of the images in the system 

o Edit image metadata 

o Scale images any way you want on the fly. Scaled versions are cached 



I I . File Attachments 

o Attach files to articles 

o Files can have descriptions 

o You can specify whether the file should be displayed in the browser or popup 
a download window 
12. Comments 

o Readers can make comments to articles 

o Comments can be linked to a forum 

o Flexible implementation: allow anyone to comment, just subscribers, 
logged in 

o Comments can be moderated 

o Built-in CAPTCHA for spam prevention 
I 3. Works with SSL on both the front-end and back-end 

SITE DESIGN 

Newscoop has its own template language specifically made for online newspapers and 
magazines. It allows you to customize your site however you want. 

• You have access to the following data objects: 

o publications 

o issues 

o sections 

o articles 

o topics 

o current user 

o current language (e.g. automatically show the user an article in their language) 

• Control statements such as IF and LIST 

• Include other templates 

• Built on the SMARTY templating engine which allows easy customization and 
inclusion of third party modules 

ADMINISTRATION 

1 . Fine-grained access control, you can create different user types such as: 

o journalists 

o editors 

o photographers 

o photo editors 

o subscriber managers 

o site administrators 

2. Multiple author support with contact information, biographies and article tracking 

3. All administration actions are logged 

4. Security 

o Login page secured against automated scripting attacks with a CAPTCHA 
o Login password is encrypted when sent to the server 

5. Backup 

o Command-line "backup" and "restore" scripts make it easy to backup your 

entire site and restore it with one command 
o You can also easily transfer your site from one server to another using these 

scripts 



6. Automated Feedback and Bug Reporting 

o If something goes wrong in the administration interface, a special screen will 

appear which allows you to submit the problem back to the Newscoop team 
o You can also submit feedback directly in the administration interface, such as 

suggestions or feature requests 

DEVELOPERS 

• Completely open-source LAMP development stack (Linux, Apache, MySQL, and 
PHP) 

• Easy to use object-oriented API to develop plugins or alternative interfaces 

• Easy-to-read code 

• Open development process - all planning, specs, and reviews are done in the open. 
Developing Newscoop is a community process 

FULL COMMERCIAL SUPPORT 

• Paid per-incident support is available from Sourcefabric 
(http;//www.sourcefabric.org). Guaranteed support contracts ensure a 24-hour 
response time 

• If you need additional features in Newscoop, they can be ordered from Sourcefabric 
at a very reasonable cost and delivered in a timely manner 

• Sourcefabric has a team of full-time developers working to make Newscoop easier to 
use, with the features you want 

• Community support is available via mailing lists and forums 
(http://forum.sourcefabric.org) 



INSTALLATION 



3. BACKUP AND UPGRADE 

4. AUTOMATED INSTALLATION 

5. MANUAL INSTALLATION 

6. INSTALLATION STEPS 

7. INSTALLING A SAMPLE PUBLICATION 
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. BACKUP AND UPGRADE 



Before upgrading a running server to the latest version of Newscoop, it is strongly 
recommended that you back up your publication database, templates, images, file 
attachments and configuration files. First, log in to the administration interface (see the 
Cetting started chapter in this manual for details). Click on Actions in the main navigation 
menu. At the lower end of this menu, click Backup/Restore. 




On the Backup/Restore page which opens, click the Make new backup link next to the 
green plus sign icon. 
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A dialog box will ask you if you are sure you want to make the backup. 
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Click the OK button, and a pop-up window will display the progress of the backup. Once 
the window reports Backup saved to file: you can click the Close link to return to the 
Newscoop administration interface. 
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I http://r>ewscoop-dev.sourcefabric.orgi^master/aclmiiVbackup.php?ad:ion— backup 



#! /usr/bin/env php 

Newscoop Backup Utility 

Backup script version: 3,5.G "Bea" 
Backing up newscoop 

* Backing up the database. ., done. 

* Backing up the templates. , .done. 

* Backing up images ,. .done. 

* Backing up file attachments. ., done. 

* Backing up configuration files. . .done. 

* Creating tarball. , .done. 

* Cleaning up. . , done. 

Backup saved to file; 
Aar/vwv/canpsite-branches/master/newscoop/backup/backup- newscoop -2G11-G2-Q1- 16- 5 



Close 



On the Backup/Restore page, the backup you just made should be listed, together with any 
previous backups. 
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Click on the disk icon in the Download column to save the gzipped backup tarball (with 
the .tar.gz file extension) from your Newscoop server to your desktop computer. 
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To restore a previous backup into a running Newscoop system, click the Upload backup 
file link, and then select the backup from your desktop computer's file system. 

RUNNING THE UPGRADE SCRIPT 

After you have completed the backup successfully, update your Newscoop installation using 
either the automated or manual methods described in the following chapters. Then run the 
upgrade.php script in your web browser, for example: 

http : //www . example . com/ upgrade -php 



II 
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AUTOMATED INSTALLATION 



Ready made packages of Newscoop are available for Deblan and Ubuntu GNU/Llnux via 
secure apt. This is the recommended installation method for Newscoop, because it offers 
automatic updates and resolution of package dependencies. This guide assumes that you 
have sudo or root powers on the target server - if not, you need to ask your system 
administrator to install Newscoop for you. 

INSTALLING MYSQL 

Two components of the MySQL database management system are needed by Newscoop: 

• the server 

• the client programs 

Depending on your requirements, you may prefer to run the MySQL database server on a 
separate machine from the MySQL client. The MySQL client must be installed on the same 
machine as Newscoop. On Debian/Ubuntu, installing the mysqi-server metapackage will 
install the latest versions of both the server and client packages. 

$ sudo apt-get install mysql-server 

During the installation of MySQL, you should be prompted to set a root password for the 
MySQL server, which is an important security feature. Make a note of this password and 
keep it in a secure place, as you will need it shortly. 



1 Configuring mysql-server-5. 1 | 

While not mandatory, it is highly recommendad that you set a password 
■for the MySQL administrative "root" user. 

If this field is left blank, the password will not be changed. 

New password for the MySQL "root" user: 



Note that the MySQL root user is different from the system root user, and should have a 
different password. 

SETTING UP THE DATABASE USER AND PASSWORD 

An existing Newscoop installation should have a named database already set up on a MySQL 
server, with access protected by a username and password. For a new installation of 
Newscoop, you will need to tell the installer to create a database to store your content in. 
This means you will need a MySQL user account with database creation privileges set up in 
advance. If you don't already have an account, you can set up a database username and 
password for the Newscoop installer to use with the following steps. 

I . Connect to the database management system using the root account and the password 
that you set during the MySQL installation. 
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$ mysql -u root -p 

Enter password: 

Welcome to the MySQL monitor. Commands end with 

Your MySQL connection id is 34 

Server version: 5 . 1 . 41-3ubuntul2 . 8 (Ubuntu) 



or \g. 



Type 'help; ' or '\h' for help. Type '\c' to clear the current input statement. 

2. The shell prompt will change to a mysql> prompt, which requires a semicolon at the end 
of each command. Create a user account for Newscoop to connect to the database, limiting 
it to connecting from the localhost if Newscoop and MySQL are to be installed on the 
same server. Otherwise, specify the server that Newscoop will be connecting to MySQL 
from. Make a note of the username (newscoop_user in the example below) and password 
(newscoop_user_password in the example) that you set, in a secure place. You will need 
these details during the Newscoop installation. 

mysql> CREATE USER ' newscoop_user ' @ ' localhost ' 
-> IDENTIFIED BY ' newscoop_user_password ' ; 
Query OK, rows affected (0.04 sec) 

4. Grant access privileges to the user you just created. In this example, newscoop.* means 
all tables of a database called newscoop, which has not yet been created. You will need to 
provide this database name to the Newscoop installer, so that it can create the database 
later. 

mysql> GRANT ALL ON newscoop.* 

-> TO ' newscoop_user ' @ ' localhost ' ; 
Query OK, rows affected (0.00 sec) 

5. Exit from the database management system and return to the shell prompt. 

mysql> quit; 

Bye 
$ 

SETTING UP THE SECURE APT REPOSITORY 

To add the repository that contains the Newscoop software, open the sources.list file in 
the nano editor with: 

$ sudo nano /etc/apt /sources . list 




Type your password, and the sources.list file will open. For Ubuntu Lucid LTS, scroll to the 
end of this document and add the following line: 

deb http://apt.64studio.com/backports/ lucid-backports main 

For Ubuntu Maverick, substitute maverick-backports in place of lucid-bockpons. For Debian 
Squeeze, substitute squeeze-backports in place of lucid-backports. 
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Press Ctrl+O to write out the sources.list file, and Ctrl-X to quit the nano editor. 
You now need to update your sources. Type: 

$ sudo apt-get update 

You will probably see an error message about a missing public key. 




To fix this, you need to install the 64studio-apt package, which contains the package signing 
key: 



$ sudo apt-get install 64studio-apt 
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daniel@office:"$ sudo apt-get install 



...- following NEW pack; 

G4studio-apt 

upgraded^ 1 newly installed, to remove and not upgra 
Need to get 3.382B of archives. 

-aticn, 45+lkB of additional disk space will 
cannot be authenticated! 



^ verification [y/N]? 
^backpcrts/ lucid-ba 



G4studio-apt+ 
(Reading database +++ 271G09 files and directories currently installed*) 
Unpacking G4studio-apt (from ,„/G45tudio-apt_0,l''lucidl_alKdeb) ,** 
Setting up 64studio-apt (O.l'^lucidl) ... 



Update your sources again, to confirm that you are now using a trusted software 
repository: 

$ sudo apt-get update 

You should no longer see the error message about the public key. 

INSTALLING THE NEWSCOOP PACKAGE 

After confirming that the secure apt repository is set up, you can install the Newscoop 
package: 

$ sudo apt-get install newscoop 

This command will install all of the Newscoop components, plus any other packages that 
Newscoop requires in order to run. 




The package installer will ask you a few questions about the kind of server you want to set 
up, such as the Apache configuration that you require. 
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Configuring newscoop \- 



This setup script can perform apachs web-server configuration so that 
you can connect to newscoop directly after this installation. 

Production systems should choose "dedicated v-host". This option will 
ask for a Server host-name [FQDN) and will create a minimal apache vhost 
configuration that you can adapt. 

"system-wide [all vhosts)" apache-conf ig configures 

http : //all- apache- virtual -hosts/newscDop/ using /etc/apache/conf .d/ This 
IE the recommended if newscoop is the sole web-service on this server 
and also for test-installations. 

"no, thanks": no problem. You're welcome to set it up however you like. 
Note that the files in /etc/newscoop/ may come in handy doing so. 



Optionally, install XCache for optinnunn Newscoop performance: 

$ sudo apt-get install php5-xcache 

Configuration options for XCache are covered in the Manual installation chapter. 

Finally, check that Newscoop is running. Open a web browser with the URL of the web 
server that you have installed, such as http://www.example.com. For a test installation 
accessed from the same machine, this URL might be: 

http: //locaihost/ 

If you see the Newscoop installer page, and you do not wish to adjust the default XCache 
settings, you can now skip the chapter Manual installation and proceed to the chapter 
Installation steps. 
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5. 



MANUAL INSTALLATION 



The following manual installation method is intended for more experienced system 
administrators, and assumes that you have sudo or root powers on the target server. If 
ready-made packages of Newscoop are not available for your GNU/Linux distribution of 
choice, you can install the software manually using the tarball available for download from 
Sourcefabric: 

http://newscoop.sourcefabric.org/ 

DEPENDENCIES 

Before performing a manual installation, you will have to verify that all of the dependency 
packages that Newscoop requires are already installed and working. These dependencies 
are: 

1 . Apache web server (http://www.apache.org) version 2.0.x or newer. 

On Debian or Ubuntu GNU/Linux, you can install the apache2 metapackage, which will 
install all of the web server packages you need. 

$ sudo apt-get install apache2 

2. MySQL database management system (http://www.mysql.com) version 5.0 or 
newer. 

Two components of MySQL are needed for Newscoop: 

• the server 

• the client programs 

These components are usually packaged separately, because you may prefer to run the 
MySQL server on another machine from the MySQL client, which must be installed on the 
same machine as Newscoop. On Debian/Ubuntu, installing the mysqi-server metapackage 
will install the latest versions of both the server and client packages. 

$ sudo apt-get install mysql-server 

During the installation of MySQL, you should be prompted to set a root password for the 
MySQL server, which is an important security feature. Make a note of this password and 
keep it in a secure place, as you will need it shortly. 



-| Configuring mysql-server-5. 1 |— 



While not mandatory^ it is highly recommended that you set a password 
for the MySQL administrative "root" user. 

If this field is left blank, the password will not be changed. 

New password for the MySQL "root" user: 
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Note that the MySQL root user is different from the system root user, and should have a 
different password. 

3. PHP scripting language (http://www.php.net) version 5.0 or newer. 
The following PHP modules must be installed: 

• php5-cli - Command Line Interface module 

• phpS-mysql - functions for accessing the MySQL database server 

• php5-gd - provides a module for handling graphics from PHP scripts 

$ sudo apt-get install php5-cli php5-mysql php5-gd 

These modules have the same names in the equivalent Debian/Ubuntu packages. You will 
also need the PHP module for the Apache web server, which has the package name 
libapache2-mod-php5 in Debian/Ubuntu. This package should be installed automatically 
as a dependency when installing the PHP packages mentioned above. 

4. lmageMagicl< (http://www.imagemagick.org). 

Needed for creating thumbnails of images. Available in Debian/Ubuntu's imagemagicl< 
package. 

$ sudo apt-get install imagemagick 

All of these Newscoop dependencies are available as standard packages in most GNU/Linux 
distributions. You should be able to find them using your distribution's software package 
manager, although the exact package names can vary from the examples given above for 
Debian/Ubuntu. 

SETTING UP THE DATABASE USER AND PASSWORD 

An existing Newscoop installation should have a named database already set up on a MySQL 
server, with access protected by a username and password. For a new installation of 
Newscoop, you will need to tell the installer to create a database to store your content in. 
This means you will need a MySQL user account with database creation privileges set up in 
advance. If you don't already have an account, you can set up a database username and 
password for the Newscoop installer to use with the following steps. 

1 . Connect to the database management system using the root account and the password 
that you set during the MySQL installation. 

$ mysql -u root -p 

Enter password; 

Welcome to the MySQL monitor. Commands end with ; or \g. 

Your MySQL connection id is 34 

Server version: 5 . 1 . 41-3ubuntul2 . 8 (Ubuntu) 

Type 'help; ' or '\h' for help. Type '\c' to clear the current input statement. 

2. The shell prompt will change to a mysql> prompt, which requires a semicolon at the end 
of each command. Create a user account for Newscoop to connect to the database, limiting 
it to connecting from the localhost if Newscoop and MySQL are to be installed on the 
same server. Otherwise, specify the server that Newscoop will be connecting to MySQL 
from. Make a note of the username (newscoop_user in the example below) and password 
(newscoop_user_password in the example) that you set, in a secure place. You will need 
these details during the Newscoop installation. 

mysql> CREATE USER ' newscoop_user ' 8 ' localhost ' 
-> IDENTIFIED BY ' newscoop_user_password ' ; 
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Query OK, rows affected (0.04 sec) 

4. Grant access privileges to the user you just created. In this exannple, newscoop.* means 
all tables of a database called newscoop, which has not yet been created. You will need to 
provide this database name to the Newscoop installer, so that it can create the database 
later. 

mysql> GRANT ALL ON newscoop.* 

-> TO ' newscoop_user ' @ ' localhost ' ; 
Query OK, rows affected (0.00 sec) 

5. Exit from the database management system and return to the shell prompt. 

mysql> quit; 

Bye 
$ 

PHP MODULES 

On Debian or Ubuntu, the PHP modules that you have installed should be configured 
automatically, with an entry for each module added to the /etc/php5/apache2/conf.d/ 
directory. You can also create your own PHP customization options using files in that 
directory, which should not be overwritten when the main php.ini file is upgraded. 

On other distributions of GNU/Linux, you may need to add a line for each module to the 
php.ini file, such as /etc/php5/apache2/php.ini or similar. The following extensions should 
be enabled. If the line is already present but starts with the semi-colon comment ';' you will 
need to remove this character for the corresponding extension to work. 

extension=gd. so 
extension=mysqli . so 
extension=mysql . so 

PHP CONFIGURATION 

On any GNU/Linux distribution, the php.ini file contains some default settings which 
should be checked or adjusted to enable optimum Newscoop performance and security. 
You can do this by opening the file in your text editor: 

$ sudo nano /etc/php5/apache2/php . ini 

The recommend settings are that you should: 

1 . Turn off registerglobals because it's a potential security hole: 

register_globals = Off 

2. Set the amount of memory available to at least 1 28MB: 

memory_limit = 128M 

3. Turn off magic quotes: 

magic_quotes_gpc = Off 

4. Allow HTTP file uploads: 

file_uploads = On 
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The values above are the default settings on Debian or Ubuntu. You may wish to adjust the 
following two settings, which affect the maximum size of media that Newscoop users can 
upload. 

5. The maximum size of POST data that PHP will accept defaults to 8MB on Debian/Ubuntu. 
You may find that you need to set this higher, for example: 

post_max_size = lOOM 

6. The maximum allowed size for uploaded files defaults to 2MB on Debian/Ubuntu. This is 
likely to be insufficient for large multimedia attachments, so you may wish to set this value 
higher. However, it must not be higher than the maximum POST size set above, otherwise 
large uploads may fail. 

upload_max_f ilesize = lOOM 

7. You may also wish to disable automatic session garbage collection, which can cause 
permissions errors to be shown in the browser if your server runs Debian or Ubuntu. 
These GNU/Linux distributions use a cron job /etc/cron.d/php5 to perform garbage 
collection instead. 

session . gc_probabilitY = 

APACHE CONFIGURATION 

The Apache web server's configuration will need to be adjusted to set the path to the 
Newscoop files and templates. On Debian or Ubuntu, Apache configuration files are usually 
found in the /etc/apache2/sites-available/ directory. 

1 . Create a file such as newscoop containing a virtual host definition. 

$ sudo nano /etc/apache2/sites-available/newscoop 

For a publication with the domain name www.example.com, you could use a virtual host 
definition like the following: 

<VirtualHost *:80> 

Document Root /var/www/ news coop 
ServerName example . com 
ServerAlias www. example . com 
Direct orylndex index .php index .html 
<Di rectory / var/www/ news coop> 

Options -Indexes FollowSymLinks MultiViews 
AllowOverride All 
Order allow, deny 
Allow from all 
</Directory> 
</VirtualHost> 

If the ServerName or ServerAlias that you are using is not yet set up in DNS for this 
particular machine's IP address, you can create a temporary hostname in your /etc/hosts/ 
file which will enable you to test the installation locally. 

2. Disable the default Apache configuration, if you aren't using it. 

$ sudo a2dissite default 

Site default disabled. 

Run ' /etc/init .d/apache2 reload' to activate new configuration! 

3. Enable the Newscoop configuration that you just created. 

$ sudo a2ensite newscoop 
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Enabling site newscoop. 

Run ' /etc/init . d/apache2 reload' to activate new configuration! 

4. You may also need to enable Apache's rewrite module. On Debian/Ubuntu, you can do 
this with the a2enmod command; 

$ sudo a2enmod rewrite 

The server should respond: 

Enabling module rewrite. 

Run ' /etc/init . d/apache2 restart' to activate new configuration! 

5. Restart Apache as suggested by the output of the command above, so that the 
Newscoop configuration and the new modules can be loaded: 

$ sudo /etc/init . d/apache2 restart 

The server should respond: 

* Restarting web server apache2 [ OK ] 

6. Extract the Newscoop tarball that you downloaded in your working directory. This 
action will generate a directory named 'newscoop'. 

$ tar -xvzf newscoop-3 . 5 . . tar . gz 

7. Change into the 'newscoop' directory, and examine the contents with the Is command. 

$ cd newscoop 
5 Is 

The output of this command should appear similar to: 

ChangeLog COPYING CREDITS documentation INSTALL README src UPGRADE 

8. Copy the contents of the src directory into the DocumentRoot directory of the Apache 
virtual host that you set up, such as /var/www/newscoop/ 

$ sudo cp -r newscoop/* /var/www/newscoop/ 

9. Change the ownership of the DocumentRoot directory to the username of the web 
server, for instance www-data on Debian or Ubuntu. 

$ sudo chown -R www-data /var/www/newscoop/ 

1 0. Open a web browser with the URL of the Apache ServerName or ServerAlias that 
you set up earlier. If you see the Newscoop installer page, you are ready to proceed 
through the installation steps. 

INSTALLING XCACHE 

This step is optional, but highly recommended for optimum Newscoop performance. On 
Ubuntu, you can install XCache with the following command: 

$ sudo apt-get install php5-xcache 

You may wish to adjust the XCache configuration for your particular requirements: 

$ sudo nano /etc/php5/conf . d/xcache . ini 
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On a Debian or Ubuntu server with two processors, example adjustments to the default 
configuration might be: 

; Configure this to use admin pages 
xcache . admin . user = "my_admin_name" 

; xcache . admin .pass = md5 ($your_password) 

xcache. admin. pass = "5f 4dcc3b5aa765d61d8327deb882cf 99" 

; to enable : xcache . size=64M etc (any size > 0) and your system mmap allows 
xcache. size = 32M 

; set to cpu count (cat /proc/cpuinfo | grep -c processor) 
xcache. count = 2 

; for *nix, xcache .mmap_path is a file path, not directory, 
xcache .mmap_path = "/var/ cache /xcache" 

The value of xcache.admin.pass shown above is just an example. You should generate 
your own md5 hashed password using a piped command such as; 

$ echo -n "password" | md5sum 

You can set up your Apache VirtualHost to allow administrator access to the XCache 
statistics page from the localhost, or a specific IP address that you determine. Add a stanza 
like the following to the VirtualHost definition that you created earlier: 

# php xcache stats 

Alias /xcache/ /us r/share/xcache /admin/ 

<Directory " /usr/ share /xcache/admin/ "> 

AllowOverride None 

Options ExecCGI 

Order allow, deny 

Allow from localhost 
</Directory> 
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6. 



INSTALLATION STEPS 



At the URL of your publication's new site, Newscoop should display a Pre-installation Check 
page indicating the status of dependencies. 













^^^^^^1 ^^^m 




Progress... 
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PHP CLI [Command Line) 
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APC (PHP CacllB) Support 
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Session Handling Support 
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Rewtlte Module 
Document Root Wtltable 
Cron Jobs Writable 
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Yes 
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Templates FolderWnfable 




Yes 


Templates Cache Writable 
Pluglns Folder Writable 
Backup Folder Writable 
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Recommended Cu 
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Safe Mode 


Off 


Register Clobals 
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Off 


File Uploads 
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□n 
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If there are any No entries in the Status column, check your Apache server logs for errors. 
Otherwise, click the Next button to run through the installation steps. 

The next step is for you to review the license under which Newscoop is distributed, which 
is the GNU General Public License version 3. Click the Next button if you accept the 
license terms. 
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Progress... 






: l_ICENSE 
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■e Foundation, Inc. 
. Cambridge. MA G2139. USA 
tribute verbatim copies 
g it is not allowed. 

esigned to take away your 
ntrast, the GNU General Public 
freedom to share and change free 

free for all its users, This 

of the Free Software 
■ program whose authors commit to 
oundation software is covered by 
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Pre-installation Check 
License ■♦ 

Database SettingE 
Main Configuration 
Sample Site 
Automated Tasks 
Finish 




a 





Next, you need to set the Server Name/Address for the database, which will be localhost 
if Apache and MySQL are running on the same machine. You only need to enter a number 
in the Server Port field if you are using a non-standard MySQL port. Then enter the User 
Name, User Password and Database Name that you set up earlier. 





^^^^^^9 ^^^H| 


Progress... 








Pre-installation Check 
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Main Configuration 

Sample Site 
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Server Name/Address: 


localhoit 


Server Port: (OpjijjiaJ) 

User Name 

new5coop_u5er 

U5«r Password: 


a 






Database Name: 




newscoopi 









if you enter a Database Name which already exists on the specified server, you will asked 
if you wish to Overwrite Database. Only click the Yes option if you are very sure that 
any production databases are fully backed up. 
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^^^^^^9 ^^^fl| 


Progress... 
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Main Configuration 

Sample Site 
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Finish 


Ttiere is already a database named newscoop. 

it you are sure to overwrite it, checit Yes for the option beiow, it not, just 
change the Database Name and continue. 

Server Name/Address: 

local host 

Server Port: (OpfwnaJ) 




3306 


User Name: 

new&coap_JBeir 

User Pas sword 






Database Name: 


newscoop 


Overwrite Database: Yes[®] Ho 







Next is the Main Configuration page, which is where you set the name of your first 
publication, as well as the password and email address for Newscoop's admin user. This 
user account is critical for management of your Newscoop publications, so make sure that 
you keep the password somewhere secure. 





^^^^^^9 ^^^m 


Progress... 
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Site Title: 
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Confirm Password: 
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Newscoop includes a demonstration publication template which you can use for evaluation 
purposes. For the demo template to work, you will need to set up a Publication alias with 
your chosen ServerName later. If you already have a template designed, or wish to start 
with an empty template set, click the No, thanks! radio button. 
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Progress... 
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The next page of the installer sets up automated maintenance tasks for your Newscoop 
server, using cron jobs. 





^^^^^^9 ^^^^H 


Progress... 








Pre-installation Check 
License 

Database Settings 
Main Configuration 
Sample Site 
Automated Tasks « 
Finish 


Autopubllsh: Modifies the status of issues and arlides scheduled for 
certain actions. 

Events Notifier: Sendsermailsto administrative users containing the 
latest events that took place in Campsite. 

Inde^ter: Indexesthe article content (update the search engine 
database]. 

Statistics: Updates Wst] site statistics. 

Subscriptions Notifier: Sends emails to subscribers alerting them 
when their subscription ends. 

You can read more on this in the Campsite manual. 


^ 









Once installation has completed, two large buttons are shown. Clicking on the upper 
button, with a tools icon, redirects you to the Newscoop administrator interface. The lower 
button takes you to the Sourcefabric website, for further information and support on 
Newscoop. 
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Progress... 












Pre-installation Check 
License 

Database Settings 
Main Configuration 
Sample Site 
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Finish ^ 




Administrator ^ 












We kM me to 
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^ 





If you attempt to access the reader side of your new website before logging into the 
administration interface for the first time, you may see an error message in your web 
browser that the site alias (such as www.example.com) was not yet assigned to a 
publication. This aspect of Newscoop configuration is dealt with in the Creating a publication 
chapter of this manual. 



"SMMI 



File Edit View History Bookmarks loois Help 

S O A 



^ #■ 



gl The Journal 



http://www.example.com/ ► v | [ypvl 
1 * 



Newscoop 



SOURCEFABRIC 
Error: The site alias 'www.example.com' was not 
assigned to a publication. Please create a 
publication and assign it the current site alias. 
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7 



INSTALLING A SAMPLE PUBLICATION 



Newscoop's templating engine allows you to customise your online publication with full 
separation of design and content. You do not need to compromise when tailoring the 
template to fit your design, but some Newscoop publications prefer to start with a ready- 
made template. 

On the Sourcefabric website you can find a number of sample publications for Newscoop, 
providing all elements of a publication: database structure, sample content and the actual 
templates. These sample publications are provided in the form of Newscoop backup files. 

Warning: if you already have one or more publications on your Newscoop 
server, uploading a sample publication will erase your entire database and files 
from all your publications, and replace them with sample content! Do not 
attempt this procedure on a production Newscoop server unless you have 
backed it up first! 

Using the Backup/Restore feature of Newscoop, you can install a sample publication file 
after downloading it from the Sourcefabric website to your local computer's desktop. Then 
log in to the Newscoop administration interface, and select Backup/Restore from the 
Actions menu. 
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On the Backup/Restore page, click the Upload backup file link, and click the Browse 
button to select the sample publication file from your local computer. Then click the Save 
button to upload the file. After upload, click the Restore icon for the sample publication, 
on the right side of the list of the available backup files. This orange and white icon looks like 
a life preserver, of the kind you might find on a boat. 
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The restore process starts with an empty pop-up window, connecting to the server. Do 
not close this window, otherwise the restore process will be interrupted. The process takes 
some time (it can be minutes, depending on the size of the publication and the speed of the 
server). After the restore process has finished, there is only one user in the system, the 
Administrator, with the login and password both set to: admin 

To finish the process, log in as admin. Then go to Content > Publications and select 
"Configure" in the new publication. Now add the URL of your publication as a site alias. 



T Add new publication U Deleie 



General attributes 

Number 1 
Name: 

Default Site Alias: 

Delajit language: 

URL Type: 



Ushahidi Cooker 



d 



English 



Edit aliases^ 

Edit languages 



short names ^j 



^Article title 
Searcti engine optimization: L ^ Article Iseywords 
D Article topics 



Invalid URL Template: 



d 



The sample template should now be visible at the URL of your publication. 
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8. 



GETTING STARTED 



Newscoop enables you to host multiple, multi-lingual publications on the same web server. 
The process of setting up a new on-line publication with Newscoop can be divided into 
three steps: 

1. Configuring the publication, and specifying the templates to be used 

2. Establishing the structure of your publication, with issues and sections 

3. Adding content, managing content, and publishing it 

This part of the Newscoop manual is aimed at editors and journalists working their way 
through these three steps. It assumes that the web server you will use is already up and 
running with Newscoop, and that templates have been designed for your publication. If you 
chose to install the sample templates when following the Installation Steps chapter, you can 
use these templates to learn about Newscoop in advance of having your own templates 
designed. 

If you are a system administrator setting up a Newscoop server for production use, you 
should also read the administration chapters, later in this manual, before you begin work on 
the server. 

If you do not yet have your own Newscoop server running, you can follow the steps in this 
manual using the Newscoop demonstration server and sample templates provided by 
Sourcefabric. 



LOGGING IN 

The first step begins with logging in to the administration interface of your Newscoop 
server. This is a special interface which is only available to the staff of your publication. 
Readers who subscribe to your online publication will log in using the home page of your 
website instead. 

By default, the URL you should enter into your web browser for the administration 
interface is the name of your website, followed by 'admin'. For example: 

http://www.example.com/admin/ 

If you installed Newscoop yourself, you would have set a password for the 'admin' user 
during the installation steps. If not, your system administrator should already have provided 
you with a login account name and password. Below the Account name and Password fields, 
click the drop-down menu to select an interface language other than the default of English, if 
you wish. Then click the Login button. 
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Newscoop^ 

SOURCEFABRIC 
Login 


Please login lo CDntinue. 

Please enter yojr user name and password 


Account name : admin 










Language : English jj 


Forgot yojr mi 
password? mjyyB| 


Newscoop 3.5.0 "Bea", tiie open content rnanagernent system for professional jojrnalists. 
© 2B11 Sourcefabric o.p.s. Newscoop is distributed under GNU GPL v.3 



Alternatively, the administration interface of the Newscoop demonstration server can be 
found at: 

http://newscoop-demo.sourcefabric.org/admin/ 

Please remember that the demonstration server is a public site, so don't enter any private 
information there. A variety of guest login accounts are set up on this system, and the 
passwords for these accounts are shown on the login page. 
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9. 



THE DASHBOARD 



After logging into the administration interface for the first time, you'll see a page which 
Newscoop calls the Dashboard. This an area into which you can add widgets for the 
administration functions that you use most often. In this way, you can customize the 
administration interface to suit your needs. Click the Add more widgets link to open a 
page where you can select from more than a dozen potential widgets. 
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On the Widgets page, click the Add to dashboard link for each widget that you would like 
to start with. You can refine your choice of widgets later, as you get to know the Newscoop 
administration interface and its functions. 
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After all the widgets that you require have been added to the Dashboard, they change from 
black to green text to show that they are active. Click the Go to dashboard link to return 
to the Dashboard page. 
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Each widget has three small blue icons in the upper right corner. From left to right, these 
icons maximize the widget to the full width of your browser window, provide general 
information about the widget, or close it. When a widget is maximized, clicking the close 
icon returns the widget to normal size. 
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Some widgets have a blue spanner icon in the upper right corner, which enables you to 
adjust a setting for that particular widget. For example, the Map search widget enables 
setting of the default map location using the spanner icon. 
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I 0. HOW PERMISSIONS CHANGE THE 
INTERFACE 

The appearance of the Newscoop administration interface changes, depending on the 
permissions that a particular staff member has. Each user sees only the options that he or 
she has the authority to use. A typical staff user (a section editor or journalist) will only see 
some of the options available to a fully authorized administrator (such as the publisher, or 
senior manager). 

When you log into the Newscoop administration interface, across the top of the page you 
will see the main navigation menu, containing the options available to you. Here is how two 
typical users would see the main menu differently. Firstly, here's how the Actions sub-menu 
looks when an administrator is logged in: 
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Add new article 
Upload new ^mplalE 
Add new publication 
Add new staff member 
Add new subscriber 
Add new user type 
Add new article type 



Change your password 

Making the Most of a SmN l™P°rt>"^l- 
Apamrient 

August StreetCruise to Rk^iviuiiyy mowtc amn']!' 
fbr Local Charities ^^^^ ^^^^^ 



Author 

Sarafi Steffwriter 



Status 

Published 



Doug las Arellanes Putilished 



And this is how the same Actions sub-menu looks when a journalist is logged i 
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II. 



MAIN MENU 



The main Newscoop menu contains a link to the Dashboard page and up to five sub- 
menus, depending on the permissions of the user who is logged in. These sub-menus are 
Content, Actions, Configure, Users, and Plugins . The menus shown below are for an 
administrator user, who has access to all sub-menu options. 

CONTENT 

Here you can find the Publications on the server, reader Comments, the Media 
Archive, and the Search page for all of the articles in the Newscoop database. For each 
available publication, there are quick links to the latest three issues, and a full list of sections 
within each issue. In the screen shot below, a sample publication called 'the Custodian' has 
been set up, with two issues in both English and Spanish. 
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ACTIONS 

This menu provides quick access to the most commonly used functions, including 'Add 
new article' and 'Change your password'. 
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Add mo le widfiets 



Mo^ Populer Aftides 



Add new article 
Upload new template 



Add new staff member 
Add new subscriber 
Add new user type 
Add new article type 

Shewing 1 to 53 of 53 entrtj Add new CO U ntjy 

Add new language 

Change your password 

CmportXML 

Making tfie Mostof a Bacftup/Restore 

Small Apartment 



On From 
Page 



On 
Section Reads 

Page 
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CONFIGURE 

Here you can configure the System Preferences for your publication, and a number of 
other functions. Templates are the files which determine how Newscoop displays content 
to readers and subscribers. Article Types describe the format of your articles, while 
Topics allow you to categorize your articles. The Languages option specifies the languages 
that journalists have to choose from when creating articles. Countries enables you to 
specify the name of a country in the local language for each territory. The Localizer allows 
you to translate the administration interface. Clicking Logs will show you the recent activity 
of all staff users, including the IP address that they have logged In from. 



)i5;HRriai)n COWISfT t ACmOHS » 


COHFISURE -r 


USH!S " PLUGINS - 


1 
1 




^^^^^^^ 


, ■ 




Templates 

Article Types 

Topics 

Languages 

■Countries 

Localizer 

Logs 


fe 


Dashboard 

Add mDiE'ividget& 






Most Papular Aitides 


K 


fl 












Showing 1 to 53 of 53 entries 











USERS 

Here you can add and edit Staff users, and manage Subscribers. You can also define Staff 
User Types, or Synchronize Newscoop and Phorum users, integrating this web 
forum system with your publication's site. The Manage Authors page enables you to 
maintain contact and biography information for each of your publication's contributors, as 
well as track the articles that they have worked on. 



■ 






■ 




Staff 

Staff Uaer Types ^ 

Synchronize Newscoop and 
Pnomm users 

f^anage Auffiors 


■ 

1 




DBshboaid 

Add mme wdgets 




1 MostPopulaiAitUes 


1 



PLUGINS 

This sub-menu provides access to additional functionality for Newscoop, including Blogs, 
Interviews and Polls plugins. 







^^^ 


Manage Plugins 




liiiiHiviHws ^ m!^^^ ^^^^B^ 
Polls ^^^y^H^I^^^B 







38 



HELP AND LOGOUT 

Up in the top right corner of the administration interface are two additional links, to the 
right of the full name associated with your login account. Help links you to the on-line 
version of this manual, via the Sourcefabric website. Logout ends your session and returns 
you to the administration login page. 
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12. 



CREATING A PUBLICATION 



Newscoop content is organized in a hierarchical structure, which conforms to the tradition 
of newspapers and magazines: Publications, Issues, Sections and Articles. Each publication is 
made up of issues; each issue is in turn made up of sections, which are comprised of 
articles. A 'breadcrumb trail' of links is present on every screen, which enables quick 
navigation between different levels of the publishing hierarchy. 

For example, after creating a publication named the "The Custodian", by clicking on "The 
Custodian" in Newscoop's list of publications, you enter the list of issues for that 
newspaper. By clicking the name or number of a particular issue, you enter its list of 
sections. By clicking the name of a section you enter the article list. By clicking the article 
title in that list, you can edit the article. 

To create a new publication, click Content on the main navigation menu, and then click 
'Publications' from the sub-menu. On the Publication List page that appears, click on 'Add 
new publication'. 



1 


CONTENT - 


ACTIONS - CONFIGURE 


USERS V PLUG INS - 1 




Content ;■ 




* AddneweubMcation 








Number Name 

[dk^kto SEC issuEsj 


Default Site Alias 


Default Language Comments enabled 


1 the Custodian 


newsoDop-dev^ou rcefabricorg 


English • 











If your login account does not have administrator rights, you will not be able to see the 'Add 
new publication' option. You may need to ask your system administrator to enhance your 
access rights. Bear in mind, however, that a good administrator would be reluctant to hand 
over those rights to more than a handful of people. If you are not among those select few, 
your Publications List will only contain the publications already hosted on your Newscoop 
server. 

The Add new publication window has three sections; General attributes and 
Comments on the left, and Subscription defaults on the right. There's a Save button 
beneath these sections. 



The fields in the General attributes section are: 

• Name of the publication (e.g. "The Prague Times") 

• Default Site Alias is the name of the web server on which your publication will be 
hosted (e.g. www.example.com). Newscoop enables multiple publications to be 
hosted on the same web server, providing that a unique alias has been set up for each 
publication by your system administrator. If you try to access the alias URL before 
this setting is made, you will see an error message indicating that the alias was not yet 
assigned to a publication 

• Default Language sets the default language of the publication for readers 

• URL type selects between the display of full path URLs, or short URLs which are 
better for pasting into newsletters and social media posts 

• Search engine optimization helps your articles to be found on the Internet 

40 



• Invalid URL Template allows you to specify the page that readers will see if they 
follow a broken or outdated link. For example, you may wish to help lost readers by 
leading them to a search page 

The fields in the Comments section are: 

• Comments enabled? Check this box if you would like your readers to be able to 
comment on articles 

• Article comments default to enabled? If you check this box, then article 
comments for any new article will default to "enabled" 

• Subscriber comments moderated? If you check this box, comments by 
subscribers will be hidden from readers until they have been reviewed by a staff 
member 

• Public allowed to comment? Check this box if non-subscribers will be allowed to 
make comments on articles 

• Public comments moderated? If you check this box, non-subscriber comments 
will be hidden from readers until they have been reviewed by a staff member 

• Use CAPTCHA to prevent spam? The reader must type in random letters or 
numbers shown before they can post a comment 

• Moderator address If comments are moderated, each time a comment is posted an 
email is sent to this address, such as 'editor@example.com' 

• From address is the sender email address shown on the email sent to the 
moderator, which should be a valid address in case of bounces. An address such as 
'robot@example.com' is suitable 
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General attributes 

Mame: 

Default Site Alias: 

Default language: 

URL Type: 



The Prague Times 



wwvK.exam ple.com 



Cesky 



d 



Eijit languages 



short names 



d 



Article title 
Search engine optimization: B Article l<eywor[is 
D Article topics 



Invalid LTRL Template: ciasslcytpiJsearch-box.tpi 



d 



Comments 

Comments enabled?: 

Article comments default to enabled?: 

Subscriber comments moderated?: D 

Public allowed to comment?: ffl 

Public commerits moderated?: 

Use CAPTCHA to prevent spam?: E) 
Moderator Address: 



editor@example.com 



From Address: 



ro botigexam p le .CO m 



^^^9 



SUBSCRIPTION DEFAULTS 

The rest of the fields are related to subscriptions, which you can adjust later if you wish. 
First, you have to select a time unit for your subscriptions; which could be days, months, 
weeks or years. 

You can set two types of subscriptions: paid and trial. Paid subscriptions have the following 
properties: 

• Currency: the subscription currency. Even if a subscription request is sent and the 
currency setting is changed before payment, the information about the subscriber's 
payment due is correctly recorded 

• Time unit cost per one section: 

o for one language: the price for access to a particular section in a single language 
o for all languages: the price for access to a section in all available languages 
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• Default time period: the usual duration of the paid subscription. This value is used 
when a reader subscribes through the website. The period for a particular 
subscription can be modified from the administration interface 



1 


Subscription defaults 




Time Unit: 


months jj 




Paid subscriptions 








Currency: 


USD 




Time ynit cost per one section: 




- one language: 


1.0O 










- all languages: 


2.00 










Default time period: 


1 


time units 


Triad subscriptions 






Default time period: 


1 


time units 









After clicking the Save button, Newscoop will confirm that the new publication has been 
created. 




Content > Publication: The Prague Titnes > 



^^ Publicatfon List Go To issues ^p 
+ Add new pubiication ^ Deiete 

Publication created. 



On the right hand side under the Subscription defaults fields, there will now be a link 
Set subscription settings by country which will enable you specify different default time 
periods for individual countries. 
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Subscription defaults 




Time Unit: 


months ^l 




Paid subscriptions 








Currency: 


USD 




Time unit cost per one section: 




- one ianguage: 


1.00 










- aii ianguages: 


2.0O 










Default time period: 


1 


time units 


Trial subscriptions 






Default time period: 


1 


time units 


Set subscription 


settinqs PVlC 


3untrv 


L^ 



This link opens the Subscription Settings by Country page, which has a link Set 
subscription settings for a country. 




Content > Pubfication: Tne Prague Times > 



+ Set subscription settinqs for a countn 



Country Defaulttime period [ironths]: 

(ciicktoedit] 

trial B ubsc ription paidsubscrlption 



If you follow this link, it opens a page with a drop-down menu for selecting the country in 
question, plus fields for the default trial and paid subscription lengths. Clicking the Save 
button returns you to the "Subscription Settings by Country" page, which should now 
show the setting you have just made. 
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13. 



CREATING AN ISSUE 



Once you have successfully created your publication, click on its name in the Publication 
List (e.g. "The Prague Times"). This will lead you to the Issue List, which will be empty to 
begin with. 




Content > Publication: Ttw Prague Times > 



+ Set subscription settings for acoum 



Country Default time period (months): 

[click to€dit) 

trial subBcriptlon paid subscription 



Click on the 'Add new issue' link. If you are creating the very first issue, you will see a page 
with fields for basic information which you will need to enter. 




Content > Publication: The PraoLie Tim^ > [Issues 



Add new rssue 


Name: 
Language; 

Number; 
URL Name; 






[January 20 U 








Iceslty 


4 


|l 1 




|20U 1| 




^[ 




Cancel | 





The Name is the name of the issue in the particular Language you specify in the drop- 
down box underneath. The Number is a unique identifier for this issue. If this is the first 
issue you've ever published, then number " I " would be appropriate. The issue number 
cannot be changed once it is specified. 

If you are planning to add older issues of your publication at a later stage to the same 
Newscoop server, you may consider continuing the series. For example, if you just 
published issue I 54 of the 'The Prague Times" before moving to Newscoop, you should 
assign number I 55 to the first issue you are creating with Newscoop. 

The URL Name field is only useful if you specified the "URL type: short names" option 
when you created your publication. This name will show up in the reader's browser 
address bar. For example, if you enter "201 11" here, the address for the issue might look 
like this: 

http : //www . example . com/2 011_1 
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Clicking the Save button tal<e5 you to the Change issue details page, where various 
options for the issue are set. On the left hand side, there are settings for the default 
templates for the front page, sections and articles. If you do not have your own templates 
yet, you can select templates from the 'classic' demonstration set that are provided with 
Newscoop. Reader polls can also be set up and edited on this side of the page. 



CONFfGURE -r USERS 



Conitenit > PubFication; The Prague Times > Issue: January 2011 [Cesky] > 



^ Issue List Go To Sections i^ 

'^ Add new Issue Ct Preview Wm Translate O Delete 



Change issue details 


Number: 
Name: 

URL Name: 

Language: 

Publication date 
fyvw-nim-dd): 

Default templates 


1 




January 2011 








2011_1 










Cesky _J 




Click here to publish tbi 


s issue 


Front Page Template: 

Section Template: 
Article Template: 




dasslc/index.lpl tJ 




classitJsecton.tpl jj 




classiciarlicie.tpl ItI 


^ 






Edit 



On the right hand side of the Change issue details page are boxes which enable you to 
set the publishing schedule for the issue. An issue can be set to be published at a specific 
date and time, and unpublished at another date and time. 
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Issue Publishing Schedule 



Date/Time 


Action 


Publish articles 


Delete 


2011-01-17 16:0€;0CI 


Publish 


Yes 


□ 


2011-D2-17 16:00:00 


Unpublish 


Yes 


m 



Schedule a new action 








Date: 

Time: 
Action: 


2011-02-17 


n 


16 


30 


" . 




Unpublish tJ 












Publish articles: 


Yes tJ 




m 


^ 







COPYING A PREVIOUS ISSUE 

If this is not the first issue you've created, you will see a different page after clicking the 
Add new issue link in the Issue List: 




Content > Pubttcation: Ttie Prague Times > Issues > 



n Use the structure of the previous issue 

Copy the entire structure in all languages from the previous issue except tor content. 
You may modify it later if you wish. 

n Create a new structure 

Create a complete new structure. 

You must define an issue ^pe for each language and then sections for them. 



"Use the structure of the previous issue" will be the usual option to choose once you are 
ready to publish additional issues, because it automatically creates a new issue with the same 
sections as the preceding one. Clicking this option opens a page which enables you to 
specify the new issue number. 



47 



Content > Publication: Ttw Ptague Tirries > Issties > 



Copy previous issue 

Copy structure from issue lumber 1 



Issue Number: 



The sections of the new issue will be empty, so that you can begin to add articles. Before 
that, the first step is to set the nanne of the new issue, because this field is not automatically 
updated: it will start out with the same name as the last issue. After changing the Name and 
URL Name fields, click the Save button to update the new issue. 




Conitent > Publication: The Prague Tirries > Issue: January 2011 [Cesky) > 



^ Issue List Go To Sections 1^ 

+ Add new Issue Q^ Preview lJSI Translate Q Delete 

Issue created. 



Change issue details 


Njmber: 
Name: 

URL Name: 

Language: 

Publication date 
fy>y^-mrTHJd); 

Default templates 


2 




February 2011 








2011_2| 










Cesky ^ 




Click here to publish thi 


s Issje 


Front Page Template: 

Section Template: 
Article Template: 




classic/index.tpl J 




classlc/section.tpl jj 




classlc/artide.tpl tJ 


^ 
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The previous templates are not copied to the new issue automatically, so the new issue 
must be linked to at least a template for the front page. 
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14. 



CREATING A SECTION 



By clicking on the name of an issue in the Issue List, you will enter the Section List. At first, a 
new issue will have no sections. 



■iff 



COWTSfT -r Acnois -r COmGUtE T 



Content > PublicotiDn: Ttie Prague Tirrtes > Issue: January 2011 [Cesl^] 



^p Issue List ^ Add new .section 

KosecSnns 



If you click on the 'Add new section' link, you will see the corresponding page appear. Here 
you must specify the Name, section Number, and URL name for the new section. 
While you can change the name of the section later, the section Number is set at the time 
when the new section is added. The URL name will be part of the URL for the new 
section, if you set the "short names" option when you created the publication. 




Content > Pii blicatk>n : Tlie Prague Titnes > Issue: January 2031 [CeslcJ] > Sections 



Add neiM section 



Name: Property 



Description: jhe hottest real estate deals in Prague 



Number: 1 
URL Name: |T~ 



E jbscriptiois: I^Udd section to ail subscriptions. 



The section Description is optional. This field is useful for displaying content that doesn't 
change very often. The information in this field will only be displayed on your site if the 
template you are using supports it. If you would like to make the new section available to all 
existing subscribers, you should check the box for this option. Then click the Save button. 
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Your next step is to set the templates for the new section on the Configure Section page. 



Configure section 

Njmber: 1 



Name: 


Proper^ 


1 








URL Name: 


|l 










Subscriptions: 


- 


dl 



Description: j^^g hottest real estate deals in Prague 



Default templates 



Section Template: classicfeecHon.tpl 



3 



ArticieTempiate: classic/arCcle.tpl 



H 



Here, you may wish to select custom templates for this new section and its articles from 
the drop-down menus. If you don't have custom templates for specific sections, you can 
use general section and article templates instead. Then click the Save button to confirm 
your choice. 
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15. 



CREATING AN ARTICLE 



The Article List for a particular section can be found by clicking on Content in the main 
Newscoop navigation menu, and following the hierarchy of Publications, Issues and Sections. 
Alternatively, use the 'breadcrumb trail' of links just below the main navigation menu. You 
can create a new article by clicking the "Add new article" link at the top of the Article List. 



s 






^^^^^^^^^^^^H 


^^^^B 




^^^^H 


^^^^^ffi 




Content > Pubticatton: 


TfiePr&gue Times > Issue: Jauary 20U (Cesky) 


Section: Property > 


^ Section List 


^ Add neuv article 












1- 


1 ^ 1 


uu 











The "Add new article" page contains three fields for entering basic information about the 
article you will create. 



Content > PuhllcaTlDn: Ttie Prague Times > Issue; January 20]1 [Cesky) > Section: Properry > Arrfcles > 
^ Article List 



Add new article 



^4ame: Librarians Love Lofl LivingI 

Type: Mews Article 
Language: Cesky 



• Name: The title of the article. You will be able to rename the article at any time in 
the future 

• Type: Select one of the available article types from the drop-down menu. If you have 
not set up any custom article types yet, only the default of "News Article" will be 
available. Refer to the later chapter on Article Types for details on how to create 
custom article types. The choice of Article Type that you make for this particular 
article cannot be altered later 

• Language: Select the language the article will be written in. A drop-down list will 
contain the additional languages you have defined for this publication, if any. The 
language choice you make at this stage is final, although you can create a translation of 
the article into another language 

When you click the 'Save' button, you will be taken to the Edit Article page. 
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16. 



EDITING AN ARTICLE 



The appearance of the Edit article page depends on the article type you are working on. 
Below, the default "News Article" type is shown. At the top right are the Edit and View 
buttons, the Save All and Save and Close buttons, and the Actions, Status and 
Language drop-down menus. 



Signed in: Daniel James 1Mb Lnaout 


Newscoop ' 








^m^BEEO 




Edit 


View 
























Actions... jr 




Status; New 


d 


Language 


Cesky ■r\ 


1^ 















Edit, View and Save buttons 

There may be times when you want to view articles rather than edit them. In this case, 
clicking the View button speeds up the page display process. It also enables you to view an 
article when it is locked by another user on the server. Once the article is published, there 
will also be a Go to live article button here. 

Save All saves the fields in the edit area without closing the page, whereas Save and Close 
both saves the page and closes it, unlocking the page for other authorized users to edit 
further. 

Actions menu 

The Actions menu contains short-cuts to commonly used functions: 

• Unlock: When you begin editing an article, you automatically "lock" it to prevent 
conflicting edits from other users on the server. Using the Unlock option means that 
other authorized users can edit the article again 

• Delete: Removes the article permanently from the Newscoop server 

• Duplicate: Copies the article to any publication, issue, or section on the same 
Newscoop server 

• Translate: Creates a new copy of the article for translation into another language 

• Move: Moves the article to another publication, issue or section on the same 
Newscoop server 

Status menu 

The status drop-down menu indicates the copy flow state of the article. There are four 
states that the article can be in: 

• New: The article is still being written. Once the contributors are ready for the article 
to be seen by the editor, they should change the status to "Submitted" 
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• Submitted: The article is under review by the editor or editors. Once the editors 
decide that the article is ready for the public to see, the status should be changed to 
"Published", or scheduled for publication at a later date and time 

• Publish with issue: The article will be published only when the issue it belongs to is 
published 

• Published: The article belongs to a published issue, and is now viewable by the 
public 

Language menu 

If multiple languages have been configured for the publication, a drop-down menu will 
enable fast switching between translated versions of the article. If not, the language of the 
article will be displayed here. 

THE EDITING AREA 

To the left of the Actions and Status drop-down menus is the editing area for the article. 



DASHBOARD COmSTT ^ ACTHHS * COm^tGUtm -w USBtS ^ n.lKIM5 ^ 



Content > Publication: Tf>p Prague Time? > issue: January 2011 [Cteskyi > Section: Property > Article: Lib 



Librarians Love Loft Living 



Authors n 

I Author jj 



Jane Q. Reporter 



I PtiDtogr^ha' ~^ 



JamesQ. Photographer 






Dste 



Created: 2011-€1-17 16:17:44 □ Last maHitieil : 2011-01-17 1S:17:44 

Deck 

As long as there are shelves^ ttiey'te tiappy 

Lead and SMS 



HHiL g — A - ^ - X. X' I 3S ti's I := i= l i styles ^-^^ Fornial ^-^^ ForrttaTiiy |i 



a a I d"° 3^ i- 1 '-n -r' 1 1 a M I IS 



LljiBrisn^aK snapping up apartments in converted waietionses. Tiiere's more space tortjootrs. ttieysay. 



The "News article" type has the following fields in the editing arex 

• Name: The title of the article 

• Author: This drop-down menu enables you to credit multiple contributors, 
including Author or Writer, Photographer, Editor, and Columnist. Type the 
contributor name in the box to the right. Click the + icon to include additional 
contributors, or click the x icon to remove them 

• Date: Since this field can order the way your articles are displayed to readers, you 
can change this date if you choose 
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Deck: a sub-heading or article teaser 

Lead and SMS: a short version of the article, suitable for sending via a text message 

gateway to phones which support the Short Message Service. The length of an SMS 

text message depends on the alphabet used, from a maximum of 70 characters in 

Chinese or Cyrillic alphabets, up to a maximum of I 60 characters in the Latin 

alphabet 

Body: the main section of the article 



COMMENTS 



Beneath the editing area, there's a box in which you can set reader comments on the article 
to be enabled, if you wish. Your templates must be designed to allow this feature. The radio 
buttons can have one of three values: Enabled, Disabled, or Locked. "Locked" means 
that no one can post comments, but any existing comments are still shown. Click the blue 
Comments link to minimize the box, saving space in your browser window. 



-v Comments 



® EiuUMl O Disabled O Locked 



Comments 



® New O Approved O Delete C 



From 
Date 
Subject 
Comment 



Daniel James 
2011-01-17 17;27;59 
never have enough rconn for hooks 
I too would love to have a loft ap attune nt with lots of shelves... 



Reply to coiitfi>ent 



Post a Comment 

Author 

Daniel James 



Subject 



Individual comments can be Approved for publication. Deleted or Hidden, using the 
radio buttons immediately above. Beneath the displayed comments is a form which staff 
members of your publication can use to add a comment of their own, perhaps in reply to a 
reader question. 
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THE SIDEBAR 

On the right side of the editing area is a vertical bar containing further options for the new 
article, in a series of boxes. Like the Comments box, all of the boxes in the sidebar can be 
minimized by clicking on the blue link in the box name. 

Publish Schedule 



Schedule the article to be published or unpublished at a certain date and time. Click the 
Add Event button to open a window with a calendar and publishing options, such as 
showing the article on its section page, or the publication's homepage. 




Jl Apartment [English] > 



Edit View 



Sa¥e(l 16:43:42 



Actions... tI Status: Submitted tI 



Language Englisti tI 



^ Publish Schedule 



201H)1-1B 16:59:00 

• Put]listi 

• Showon section page 



Locations 

Clicking the Edit button in the Locations box opens a pop-up window which enables you 
to set a geolocation (map reference) for the article. 



56 



DASHBOARD CONTENT 



:oitent > Pu btkration: Tte Prague Times > Issue: January 2011 (Cesity) > Section: Proper^ > Article: Lft 



^^ 



lAutti 



Date 

Cieal 
Deck 



/^"^ Czech Republic 

IauS I 



Librarian Loft Lacatians 



tI Last Saved Map View 




Keywords & Topics 

• Keywords: Enter words that describe your article to search engines 

• Topics: Select from a list of topics and subtopics defined by your Newscoop 
administrator by clicking on the Edit button, which opens a pop-up window. Topics 
allow you to set attributes for the article, which may be used to display the article in a 
certain way 
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1 Search 




+ D 


Wuizel 


. D 


Weather 


- D 


Cars 


D 


People In The News 


D 


Features 


+ D 


Funny 


4 D 


Fashion 


D 


Geography 


* D 


Local Sports 


D 


Olympics 


+ D 


Safety 


* D 


Business 


D 


Breaking News 


* D 


Entertainment 


* D 


AccitJents 


+ D 


Agriculture 


* D 


Local News 


* D 


Crime 


, D 


Politics 


* D 


News You Can Use 


. 


Real Estate 




Apartments 




□ Real Estate Brokers 




Buying Real Estate 




D Selling Real Estate 




Hot Propenies 



After clicking the Save and Close button, the Topics you have selected are displayed in 
the box in the sidebar. 



T Keywards £ Topics 



Keywords 



loft, apartment, prague 



Save 



Topics 



R^Q 



I Reai Esta^ 



/ Real Estate / Apartjnenis 



/ Real Estate /Buying ReaJ EstatB 



/Real Estate/Hot Properties 
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Switches 











-r Switches 




n Show article on front page 
Show article on section page 
Vlsil]le to non-subscribers 








Save 















• Show article on front page: Check this box if you want the article to be displayed 
on your publication's homepage 

• Show article on section page: Check this box if you would like the article to be 
displayed on the relevant section page 

• Visible to non-subscribers: Check this box if you want to make the article visible 
to readers who have not yet subscribed 



Info 



^ Info 



Reads 
Type 




27 

News Article 


Number 




5 


Created 


by 


Administrator 



• Reads: A number indicating the popularity of this particular article. An article which 
has not yet been published will display N/A here 

• Type: Refers to the "article type", i.e. the format of the article. You cannot change 
this field once it has been assigned 

• Number: The article's unique identification number 

• Created by: the name of the Newscoop user who created this article. You cannot 
change this field 



Media 



The Media box has two tabs, Images and Attachments. 



^ Media 












Images 


Attacliments 














+ AtlHCh 










P 


201. X 

430x430 
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• Images: You can attach images to your article which can be included directly into an 
article body field, or used in the template. Clicking the Attach button opens a pop-up 
window with a tab for attaching a new image, which you can upload from your 
computer. Another tab in the pop-up window enables you to attach an existing image 
from the Media Archive. 

• Attaciiments: You can attach any kind of file you wish to the article. The article 
template must be set up to display these files, if users are to have access to them 



Polls 



" Polls 



+ Attach 



FavmintE CMS [English) 



The Polls box enables you to add a specific reader voting poll to a specific article. Clicking 
the Attach button opens a pop-up window in which you can select the poll that you 
require. You can also create a new poll there. 

Other article types may contain different fields. Whenever you edit any of the fields, you 
will need to click either the Save All button at the top of the edit area, or any of the Save 
buttons in individual boxes. 

Note that date fields have a fixed syntax of YYYY-MM-DD (four year digits, two month 
digits and two day digits, in that order). If you enter dates in any other format, you may get 
incorrect results. 
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17. 



USING THE TINYMCE EDITOR 



The body field editor in Newscoop (a program called 'TinyMCE') allows contributors to 
perform extensive article formatting from within a web browser. You may be familiar with 
most of the functions of TinyMCE from using word processors such as Microsoft Word or 
OpenOffice.org: functions such as bold, italic, underline, and text alignment. Move your 
mouse over the icons to see a tooltip explaining what they do. Standard formatting 
keyboard shortcuts also work (e.g. ctrl+b for bold, ctrl+i for italic). 




The editor field you see on your own Newscoop installation may look different than the 
one pictured above, depending on the extent of your user rights. Typically, the editor you'll 
see is the one that contains all the functionality you need for your site, but if you feel 
something vital is missing, discuss it with your Newscoop system administrator. 

There are two Newscoop-specific features in the editor. The first is Insert/edit internal 
link, which allows you to include links to articles within the same Newscoop publication, or 
within another publication on the same Newscoop server. 




^' d> ^ s a ■ 

\hf T Font size M 



Clicking this icon opens a pop-up window with drop-down menus enabling you to select a 
specific language version of a publication, issue, section and article to link to. 
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® IteJic^S'jm SKfejgcu jiO (Bate ° m^M i^fe^fe: @ll 



\i\ http://newscoop-dev.sourcefabric.orp/master/javascript/ 



GereiBl 



-General properties 


Langijage | Engft^ ▼! 




Publication 1 the Custodian »| 




Issue 1 issue 1 ^ 




Sedian | ftea^ Estate _J 




Aitide 1 rtDme Prices RtsE 1.1% in 3rd Quarter _J 




TflUBet { Open in new window LtJiankj 1^ 





Insert 



CaTicGl 



Done 



After you click the Insert button, the internally linked text will be shown in blue and 
underlined, like a web link. 



Body 

B I U J^ \S M M 
"L g — A - ^ - X, X^ 

f la a 1^: 



- I '^m m'^ Y 



H\B is Itie HuM!^ editoriiside l^e«iBCOog . | 



The second Newscoop-specific feature is Newscoop Subhead, which allows you to break 
your text into different pages. (Your templates must be configured to use this option). 



M 


^ f> 


n 


\m ^ 


— Pi 


Paragraph 


- 


Fontteidy 


- FontsB* 


- 





Enter the text for the subhead into the editing window, select it with the mouse, then click 
the Newscoop Subhead icon. The subhead text will now be shown with a dashed outline. 
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Body 




HT.L g — A ^ ^ ^ X. x= lift i;^ 


"ITiis fe ttie TinvMCE editor inade NewscooD. 


1 Example subhead; 
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18. 



MANAGING CONTENT 



The "Article List" page is displayed when you enter a particular section via the Content 
menu, by following the hierarchy of publications, issues and sections. Alternatively, use the 
breadcrumb trail to jump to the section that you're interested in, and then click the "Go to 
Articles" link. 



Conrtent > Pu h licatfo n : tie Custodian > Issue: r5 s uel (Euglis h) > Section: Real Estate 



Article List: Real Estate 

^ Section List "^ Add nei^ article 

i— Selectaction 



:3 



Search: 



StKnvlrtg 1 to 5 tjf 5 enttes - fittetirtg from 102 tecottls 
E^revlous 1 Next Last 



D 
D 
D 
D 
D 



I Name 

I 

Making the Most of a Small 
Apartment 

Real Estate Agency Celebrates 
50th Anniversary 

Open House at Fairfield Mansion 

Local Neighborhood On The 
Comeback Trail 



Type Author Sta 

NewsArticle Sarah StaflV^lriter Publist 

News Article Douglas Arellanes Publlsl 

NewsArticle James Q. Reporter Publlsl 

NewsArticle DouglasArellanes Publlsl 



To edit a specific article, simply click on its Name, and you will be taken to the "Edit 
Article" page. A locked article is one that is being edited at that moment, as shown in the list 
by a padlock icon to the left of its name. Articles being edited by other users on the 
Newscoop system also have a pink background in the list. 
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Search: | j 


Shcwir>g 1 Id 5 of 5 entii^ 


Iteing from 102 reconte 


First 


Previous 


1 j Next 


Last 1 



D 
D 
D 
D 
D 
D 



a Making the Most of a Small 
Apartment 



Type 

News Article 



A Real Estate Agency Celebrates ^ ... 
50tn Anniversary iM^wbrtiuuH 



Open House atFairfield Mansifj^n NewsAnicle 
News Article 
News Article 



Local Neighdorhood On The 
Comieback Trail 



Home Prices Rise 1.1% in 3rd 
Quarter 



ShDwir>g Ho 5 of 5 entries - Hsmg ft'oni 102 reccfiJs 
I First II Previous ]| 1 ] Next 11 Last 



Display 1 10 jj records 



Author 

Sarah Staffwriter 
Douglas Arellanes 
James Q. Reporter 
Douglas Arellanes 
Douglas Arellanes 



Status 

Subnnitted 

Publish witf^ 
Issue 

Publish witi", 
issue 

Publish witf 
issue 

Publish witf 
issue 



To find out who is editing an article and when it was locl<ed, clicl< on the article Name in 
the list. A page will open with the name of the editor, and buttons offering the options of 
unlocking or viewing that particular article. Using the View option means that you will not 
be able to overwrite another contributor's work while it is still in progress. 



ACTKJNS - 



CONFIGURE - 



PLUG INS - 



lian > issue: issiiel [English] > Sectioiii: Cars > Aiticle: Aiigjst Street Crjise 



Article is locked 

The article has been locked by Peir JaSek (|}etr.jas«k} 28 minut)&[s) ago. 



Unlock 



^^^H 



Cancel 



MULTIPLE ACTIONS 

The Article List allows you to perform other actions besides editing the article, and you can 
perform these actions on multiple articles at once. To perform an action on one or more 
articles, click the checkbox to the left of the article name. The articles you have selected will 
be highlighted with a light blue background. 
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SvM/ing 1 to 5 of 5 entries - Uttering from 102 records 



Next Ust 



D 



m 

D 
D 



Making the Most of a Small 
Apartment 



Type 

News Article 



Real Estate Agency Celebrates Mpw^ArririP 
50tn Anniversary ^^wiKiuue 



Open House at Fairfield Mansion News Article 
News Article 
News Article 



Local NeighborhDotJ On The 
Comeback Trail 



Home Prices Rise 1.1% in 3rd 
Quarter 



Auttwr Status 

Sarah Staflwriter Pubiished 

DougiasArellanes Pubiished 

James Q. Reporter Pubiished 

DougiasArellanes Pubiished 

DougiasArellanes Pubiished 



Strnwing 1 to 5 of 5 eiitries - filtering from 102 records 
I First I Previous |{ 
DIsplay flO jj records 



First Previous 1 Next L^st 



Now that you have selected the articles, go to the "Actions..." drop-down nnenu at the top 
of the list, and select the action you would like to perform: 



Status: Publish 
Status: Submit 
Status: Set New 

Toggle: 'On Section Page' P^ 

Toggle: 'Comments' 

Publish Schedule 

Unlock 

Delete 

Duplicate 

Duplicate to another section 

.J Move 

Making the Most of a Small 





m 


D 
D 



Apartment 

Real Estate Agency Celebrates 
50th Anniversary 



T/pe 

News Article 
News Article 



Open House atFairtield Mansion News Article 



Local Neighborhood On The 
Comeback Trail 



Home Prices Rise 1.1%' in 3rd 
Quarter 



Author Status 

Sarah Staffv^riter Published 

DougiasArellanes Published 

JarnesQ. Reporter Published 

DougiasArellanes Published 

DougiasArellanes Published 



Sh(nvir>g 1 to B of S entries - filtering Iron) 1.02 reconk 



First Previous 



Next Last 



Display lloH records 



For example, if you select "Toggle: 'On Front Page'", Newscoop will publish the selected 

articles on the front page of your publication. A small green pop-up window will confirm 
that the action has been processed. Some actions will take you to another page, because 
they require further input from you. These actions requiring additional input include 
Publish schedule. Duplicate to another section, and Move. 
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The article list also allows you to rearrange articles as they appear on your section page, if 
your template supports this feature. To move an article's position in the list, simply click 
anywhere in it's row, hold the mouse button down, and drag the row to the position that 
you require. The new arrangement of the articles is not finalized until you click the Save 
order button underneath the Article List. 

On the right hand side of the Article List are additional columns which relate to other 
functions, such as the number of Comments posted on the article, or the number of 
Reads it has had. In the upper right corner of the list is a Show / hide columns button 
which enables you to select the columns that you wish to view. 

To re-order the articles by Name, the number of Comments or Reads, or the Publish 

Date, click on the appropriate column heading. Column headings that enable sorting have a 
double chevron icon. After you click the Save Order button, the order of the articles on 
the relevant section page will be updated. For example, you could identify the article which 
had the most reads in a particular section, and move it to the top of its section page. 

SEARCH 

Newscoop includes another tool which provides an overview of content across all 
publications on the server. The Search feature is accessed via an entry on the Content 
menu, and has an interface somewhat like an Internet search engine. You can filter the 
search options according to a specific publication, issue or section. You can also filter by a 
number of other criteria, such as the author or publication date of the article. 



Search 



I All Publicalipns 



'^l I M Issues" 



:3 s 



Filter by... 
Publish date 
Published ater 
Published before 

IE IV 

Creator \^ 
Status 



SlKffiing 1 lo QO of 60 entries - filtering from 106 records 



Local Neighborhood On The 
Comeback Trail 



Type 

News Article 



Author Stal 

Publish 



Douglas Arellanes 



MEDIA ARCHIVE 
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Also found on the Content menu, the Media Archive page provides an overview of all 
non-text content in your publication's database. It has two tabs; one for Images, and one 
for other Files, such as audio or video files. New content can be uploaded directly to the 
Media Archive using the Add new Image or Add new file link next to the green plus sign 
icon on the respective tab. 



cotrmrT ^ Acnoie ▼ coineuRE 



USERS T nUGSBS w 



Media Archive 



Images Files 



^Add new image 



Sfwwiig 1 to 10 of 69 enitries 



D 
D 



2 3 4 5 Next Ust 



4 



C Description 

Mushrooms 



Observation point 



^ Photographer 

Ljuba Rankovic 



Ljuba Rantovic 



Ljuba Hankovic 



The main difference between the two tabs is that images are opened in the reader's web 
browser by default, whereas other files can be set to be either opened in the browser or 
downloaded by the reader instead. For this reason, it's also possible to upload images into 
the Files tab, if you wish to have the option to set them for download. 
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Conteriit > Media Archrve > 

Change attachment information 
1257956718-18-528x371.jpg 

Created: 2010-09-15 13:25:35_ Last modified: 2010^9-15 13:25:35 




Download file (*): ."X 

Type: Image/jpeg 
Size: 62.83 KB 



Change attachment inlormation 
Description: 



Do you want this file to open in the user s browser, or to automatically download? 
O Open inthe browser c^AtJtoniaticalty downioad 



IMPORT XML 

On the Actions menu there is an entry Import XML which enables you to import 
formatted content from other publishing systems, such as Adobe InDesign or WordPress. 





I 








DA 


5HBOARD CONTENT 


ACTIONS CONFIGURE USERS PLUGINS 










Add newanJcle 
Upload new template 
Add new publication 
Add new staff member 
Add new subscriber 
Add new user ^pe 
Add new article type 
Add new country 




Dashboard 






Add more widgets 






Recently Metiltied Articles 


'A J" f 










Showing 1 to 30 of 20 entrie 










Change your password 
1 Import XML . 1 

Backup/Restore 




Name 

Fairfield mansion para 
cerrar 


'^^^ Page 

PublishHi No No 
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The XML tags that you use in the export must match those used by Newscoop. For 
example, to match the default Article Type news_article you could use the following fields: 

<?xml version= ' 1 . ' encoding= 'utf-8 ' ?> 
<articles> 
<article> 

<name>Gigantoraptor Discovered in Mongolia</name> 

<k.eywords>Gigantoraptor, Dinosaur, Mongol ia</keywords> 

<author>Sarah Staff writer</author> 

<deck>Newly discovered dinosaur roamed the desert 80 million years ago</deck; 

<lead_and_sms>Imagine an ostrich that tipped the scales at 3800 kilograms, st 

<body>The huge size of Gigantoraptor is a surprise because it is a member of 
The partial fossil skeleton was found in Inner Mongolia and is from a young adult 

</article> 
</articles> 

Multiple <article> tags can be enclosed by the top-level <articles> tag, so that you can 
import a large number of articles from a single XML file. 

Once you have an appropriately formatted XML file exported from the other system, use 
the Import XML page to upload it. You will need to set the ArticleType and Language 
that you wish to import, and also if you wish to Overwrite existing articles with the 

same names. 



DASHBOARD CONTENT ^ ACTIOHS w CONRGURE * USStS ^ H^UGIMS w 



Import XML 



Import XML 



Article Type: 
Language: 

Publication: 
Issue: 

Section: 



d 



English 



3 



No publications t] 

issues _J| (Optianal) 



No sections J (Optional) 



Ovenwite existing articles?: O Yes ® No 



Input File: kw5coop/art:Lcie5_exported_fram_adobe_pnde5pgn_c5.Km([^ 



The newly imported articles will be displayed in the Pending widget on the Dashboard. 

You can click on the article names for further editing, as usual. 
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Gigantoragtor Discovered in Mongolia 



zi\ Sarah Staflwriter 



J 






Created: 2011-02-oa 15:00:lfl S iaslmodrfed ; X11-02-OB 15:00:1B 

Deck 

Newly discovered dinosaur roamed tine desert eo million years ago 

Lead and SMS 



Hm a — A • ^ ' X. x' I ffi ";i I := ■= |stjfes Pl[Fmni5 p]| Fort fen* 

^ I -I -i h*- =._ ^ I''., n' r I J ■ E 



Imogmear osliidi ll^Gti^|]ed Itie scoks at 3EC0 kiogionis, -stamding twice as tall as a human, with a so lid tail and ma 
tang , lealtiered aims wifi siiaip daws, BTid a tuiDe-ite beak. 



If there is a mismatch between the tags in the XML file you have tried to import, and the 
fields in the ArticleType that you have attempted to import to, Newscoop will list the 
empty fields and the problematic tags. You can then re-export the XML file from the other 
application with the correct tags. 



Internet Society To Lead Distinguished Panel Discussion On Internet Upgrade To IPv6 

TiTe article type tield '"Lea(i_and_SMS" does not match any field from XML Inpiii file. 

The article type field "'body"' does rtot match any field from XML input file. 

"byline" field in XML file was not loaited into database as there is not any article type field matching 

'"teaser_a" field in XML file was not loaded into database as there is not any article type field match 

"Intro" field in XML file was not loaded into database as there is not any article type field matchirtg ii 

"full_text" field in XML file was not loaded into database as there is not any article type field match! 



Should the XML file be incorrectly formatted altogether, Newscoop will refuse to import it. 
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19. 



PUBLISHING ARTICLES 



As mentioned previously, an article in Newscoop can have one of four different states: 
New, Submitted, Published, or Publish with issue. When you create an article, the 
Status: drop-down menu at the top of the editing area is set to New by default. Once your 
article copy has been drafted and is ready for the editors to see, click on this drop-down 
menu and change the Status: to Submitted. 



Edit 




\^ew 



Newscoop 



Save and Close 









Language 






Actions... tJ 




StaJLJsVNew l-^ 


Englisti tJ 






- 


Status: Publistied 




J 



Status: New 1^ 



Edit 



After changing the status to Submitted, the page will be reloaded, and a pop-up message 
will indicate that the change in status of the article has been saved. The editors will be able 
to see the fresh submission when they log in to Newscoop. Articles which are ready for 
editing are listed in the Submitted Articles view on the administrator Dashboard. 



Dashboard 

Add more wdgets 



Sut^mjtted Articles 



5l*cnviTM| 1 to 1 of 1 entres 



Type 



On From 

Page 



A Making the Most of a 
Small Apartment 



Sarati Statfwriter Sutjmlnefl No 



On 

Section 

Page 

Yes 



Stww^imi 1 to 1 ol 1 entree 



In addition, if their user accounts have been configured for notifications, an email will be 
sent to the editors to inform them about the new submission. 

Once the editors have made any required changes and are happy with the way the article 
reads and appears, they can publish the article by changing the drop-down Status: menu to 
Publish with issue. Again, the page will be reloaded, and a message will indicate that the 
article's status has changed. 
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Edit 




View 



Save and Close 



AcBons... jj 




Status: Subrriiiied j^^j 


language 


Engiish J 


■r Publish Sc 


Status: Submitted W 
Status: New 


















+ Add Event 















When an article status is set to Publish with issue it becomes visible on your public web 
site, as soon as the issue it belongs to is published. This feature enables co-ordinated 
publishing of complementary articles when a complete issue is ready for the public. You can 
check the publication status of a particular issue in the Issue List. If the issue in question has 
already been published, then new articles can be seen by the public immediately after their 
status is changed to Publish. 

The process is fully reversible, so you can unpublish articles on your site (or even change 
their status to New) as easily as you can publish them. Note that only authorized users are 
allowed to publish articles, so you will not be able to access this option if your system 
administrator has not granted you this permission. 

SCHEDULED ARTICLES 

You also have the option to publish (or unpublish) an article at a specific date and time in 
the future. You can do this from the Edit article page, using the Add Event button in the 
Publish Schedule box. 



Signed n: Qaniel James help Loaoul 



Newscoop 



Edit 




View 



d 



Acfldns... T Status: Submitted 



d 



LangLiage Engiisti tJ 



T Publish Schedule 
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After clicking on Add Event, a pop-up window will appear with a calendar and a series of 
three possible actions for the date and time that you choose: Publish/Unpublish, Show on 
front page/Remove from front page, and Show on section page/Remove from section page. 



pi fEpDiisM i Section: Real Estate > Article: K'p.kirc IKe Mp5t of a SmaU 




Schedule a new acdon 
















Date: 
Time: 

Publish: 


20U-01-20 


n 




13 
A 


ctic 


55 
ns 






PuSlish jj 














Front page: 


— 


d 














Section page: 


Show on section page 


d 
















^m 


Close 














w 



















Choose the date by clicking on the calendar, or enter a date code manually. Then enter the 
time for the event, and choose one or more actions to perform at the time you have 
chosen. After you click the Save button, the pop-up window will close, and the event will 
appear in the Publish Schedule box. 
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Sigred ir: Daniel James Held Logout 



Newscoop 



Edit 




View 



Actions. 



d 



Statijs: Submitted 



d 



Language Engiisin tI 



^ Publish Schedule 








+ Add Event 










2011-01-20 13:55:00 X 

• Publish 

• Show on section page 







Once the event is created, the actions will be performed automatically for you on the date 
and at the time you specified. After the event time, the Status drop-down menu will change 
to Published, and the event will no longer be shown in the Publish Schedule box. 
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20. 



PUBLISHING AN ISSUE 



You can draft and edit articles for a particular issue on your Campsite server without any of 
the material being available to the public. You can then publish an entire issue all at once, 
and there are two ways to do it: immediately, or by scheduling the issue to be published at a 
specific date and time in the future. Note that within an issue, you can publish or unpublish 
each article Individually; for instance, to hide an article even if the issue it belongs to has 
already been published. 

PUBLISHING IMMEDIATELY 

To publish an issue straight away, click the Publish link for the relevant issue and language 
edition in the Publish Date column of the Issue List. 



■ 


^^^^^^^^^^^^H 


^^^^H 


^^^^^^^^^m 


^^^^H 


^^^^H 


^^^ 


s 


^^^^^^^^B 


H 


^ 


B 


B 


■ 


^^^^^^^^^H 


^m 


Content > Publrcaiion: tfie Cjstodian > 




Issue List 














^ Publication List 4 Add new issue 












Number Name 

(click to see sectjons) 


URL Name 


Publish Date 

[TTY'T-HH-DD) 


Configure 


Tranalate 


Previeii 


2 is5ue2 [English) 


ia3ue2 


Not published 
PutiUsh- Schedule 


M 


m 


Q 


2 numero2 [Espanol] 


numeroZ 


2010«S9-27 09:U:15 
Unpublish -Schedule 


% 


m 


Q 


1 issuel [English] 


issuel 


2009-03-27 15*(:37 
Unpublish -Schedule 


M 


m 


Q 


1 numeroi [Espanol] 


numeral 


2010^)9-27 09:14^9 
Unpublish -Schedule 


% 


m 


Q 

















A pop-up dialog will ask you to confirm that you want to publish the issue in question, 
because this action implies that any articles which are part of the named issue will become 
available to the public instantly. 



® me 


\7mts m iMs^f^@ms3@mimi°^'-'i'^'i^-''iViiid':,'im i-ivm ©1 


♦ 


Are you sure you want to charge the issue 2. issue2 
(English] status from "Not published' to 'Published'? 






Q Cancel 




<3oK 















After clicking the OK button, the issue will be published, and the Issue List will be updated 
with the publication date and time of that particular issue. 
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Content > Publication: lite Custodian 



Issue List 



Publication List + Add new issue 



Number Name URL Name Publish Date Configure Translate Previev 

{click to see sections) [YYYY-MH-DO) 



issue2 [English] 
numero2 (Espafiol) 
issuel [English) 
numeral [Espafiol) 



2011-01-20 15-54:01 
Unpublish- Schedule 

2010-09-27 09:14:15 
Unpublish -Schedule 

2009-03-27 15:54:37 
Unpublish -Schedule 

2010-09-27 09:14:39 
Unpublish -Schedule 



M aa 



% 



Q 
Q 
Q 
Q 



To reverse the process, click the Unpublish link. Again, a pop-up dialog will ask if you are 
sure you want to change the issue's status. 

SCHEDULED PUBLISHING 

To schedule an issue to be published automatically at a specific date and time in the future, 
click on the Schedule link for the issue and language edition you require in the Publish 
Date column of the Issue List. This will open the Change issue details page, where you 
can set the date and time for this particular issue to be published. Over on the right hand 
side of the page are the Issue Publishing Schedule and Schedule a new action boxes. 



issue Publishing Schedule 



DatelTime Action Publish articles Delete 



No everts. 



Schedule a new action 








Date: 

Time: 
Action: 


20U-01-20 


Q 


16 




15 






Publish jj 












Publish articles: 


Yes_^ 




E 


m 









Click the small calendar icon to the right of the Date: field to select a specific day for 
publication. Set the time you require, and select either Publish or Unpublish from the drop- 
down Action menu. Then click the Save button. The Issue Publishing Schedule box 
will update to display the newly scheduled action. 
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Issue Publishing Schedule 



DateHlme 



Action Publish articles Delete 



2011-01-20 15:15:00 Publish Yes 



m 



Schedule a new akction 








Dale: 

Time: 
Action: 


20n-01-20 


S 


17 




oo 






- d 












P ubi is h articles: 


Yes J 
















Save 














1 



Note that you can also set the issue to be unpublished at a specific date and time in the 
future as well. This event will be displayed in the Issue Publishing Schedule box. 



Issue Publishing Schedule 






Datemme Action 


Publish aiticles 


Delete 


2011-01-201525:00 Publish 


Yes 


□ 


2011-02-201655:00 LInpublish 


Yes 


□ 



To cancel a scheduled action, click the corresponding white cross in a red box icon in the 
Delete column. You will be asked to confirm the deletion. 



® W)i if^ss'^ 'ail teOftp,«i;i: 



[■ieiSiiAuaeiZi-pm m 



# 



Are you sure you want to delete this scheduled action? 



Q Cancel <j3oK 



If you click on the Date/Time link for a future event, the Issue Publishing Schedule 

page will open, and you will be able to edit the event. Click the Save button to confirm the 
schedule change. 
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Content > Publication: ttie Custodian > issue: iLirT>ero2 [EspafloQ > 



Issue Publishing Schedule 



Issue: numero2 



Edit 


Date: 

Time: 
Action: 

Pubiish articies: 

m 




- n 


2011-01-20 


li] : 50| 


Pubiish _^ 




Yes_T| 


1 



79 



21. 



ARTICLE COMMENTS 



Reader comments can be switched on and off for a whole publication, for a particular article 
type, or for each individual article. You can also take advantage of Newscoop's management 
features to moderate (or bypass moderation for) comments from subscribers, or members 
of the general public. 

COMMENT SETTINGS IN THE PUBLICATION LIST 

To set the default comment setting at the publication level, go to Content on the main 
navigation menu, and then click Publications. In the Comnnents enabled column of the 
Publication List page which appears, publications in which readers can post comments are 
shown with a green light icon. Click on the Configure icon for the publication you wish to 
enable or disable comments for. 




Default Language Co mmente enabled URL Type Configure Delete 



English 



short names j^ 

^ 



This action opens the Configure publication page. In the Comments section, there is a 
checkbox labeled Comments enabled? and a variety of options which enable you to fine- 
tune comment settings. 





Comments 








Comments enabled?: 









Article comments default to enabled?: 









SubBcriber comments moderated?: 


D 






Public allowed to comment?: 









Public comments moderated?: 









Use CAPTCHA to prevent spam?: 
Moderator Address: 
From Address: 





























1 
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COMMENT SETTINGS FOR ARTICLE TYPES 

Perhaps you want to enable comments for all articles of a particular type, for example 
reviewarticle, but not enable them for another type, such as newsartide. Click Configure 
in the main navigation menu, and then click Article Types from the submenu. On the 
Article Types page which appears, clicking the red or green light icon in the Comments 
enabled? column toggles the setting for each article type. 



DASHBOARD CONTENT 



Article Types 



JIUU JjL 

v Add new anicie type ^ Merge types ^^ Shenv display names 



Template Type Name Fields Display Name Translate ShowiTlide Comments enabled? 

new5_article Fields News Article [en] |SS # €1 

review article Fields review article i@ O 



After you click on a green light icon, you will be asked if you are sure you want to deactivate 
comments for that article type. 



j^JgJD© (oisg)© S& (jiei?(oe/*to5fl'rarafM)(p=<S5%c-(irH;ti(?^^ iMgiSS [^ ' 


^^t^ Are yoL sure you want to deactivate comments for article 
^^ type 'newsartide'? 




Cancel 
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COMMENT SETTINGS FOR INDIVIDUAL ARTICLES 

Comments can be enabled or disabled for a number of individual articles at once, using the 
Article List page. Click Content on the main navigation menu, then use the submenus to 
navigate to the publication, issue and section that you require. In the Article List page that 
appears, use the checkboxes in the left side column to select the articles you want to enable 
or disable comments for. Then use the drop-down Actions menu and click on Toggle: 
'Comments'. 
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Content > Pu bltcation : tfie CustExlian > Issue: issuel (English:] > Sectior: Real Estate 



Article List: Real Estate 



H Section List 4' Add new article 

-Select action 



Status: Publish 
Status: Submit 
Status: Set New 
Toggle: 'On FrontPage' 
Toggle: 'On Section Page' 



Publish Schedule 

Unlock 

Delete 

Duplicate 

Duplicate to another section 

Move 



D 





A Making the Most of a Small 
Apartment 

Real Estate Agency Celebrates 
50th Anniversary 



Open House atFairtield Mansion 



D 




Local Neighborhood On The 
Comeback Trail 



Home Prices Rise 1.1% in 3rd 
Quarter 



T/pe 

News Article 
News Article 
News Article 
News Article 
News Article 



StMJwirtQ 1 to 5 of 5 entries - filtering from 101 records 



Author 

Sarah Staffi/vriter 

Douglas Arellanos Publlsl 

James Q. Reporter PublisI 

Douglas Arellanes PublisI 

Douglas Arellanes PublisI 



If the publication or article type that the articles belong to have comments disabled, then 
enabling comments for those individual articles will have no effect. 
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22 



MODERATING COMMENTS 



To prevent spam or defamatory posts from appearing in your online publication, it's often 
necessary to moderate comments from readers before they are published. A CAPTCHA 
can prevent some automated spam, but it cannot prevent spam being entered into your 
publication's comment form manually. 



Comments 
Your commeDt 



Your name (mandatory): |a.N. Other-reader 



Your e-mail (mandatoiy): |apng,g)^3^p|g^prn 
Coimnent subject: 
Coiraneiit text 



I told you so! 



A corl< on the end of the foil, 
that's the only way to mal^e 
fencing safe. 




cuxixj 



If you have configured your publication so that subscriber or public comments are 
moderated, the reader will see a message indicating that their comment has been sent for 
approval before it will be published - or not, as the case may be. 
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Comments 
Your comment 



Your comment has been sent for approval. 



Your name (mandatory): 

Your e-mail (mandatory):! 

Comment subject: [l told you soi 

Comment text 




The list of reader comments can be found by clicking Content, then Comments, on the 
main navigation menu. On the left hand side of the Comments page are two tabs; one for 
New comments, and one for Published comments. The New tab is the default, and 
beneath this any new comments are listed. The default list length is 20 comments per page. 
There is a Search field to help you find a specific set of comments, perhaps on a topical 
subject. Search results can be sorted by Date posted. Article name, Author or 
Thread, using the drop-down menu to the right of the Search field. The sort direction can 
be changed by clicking on the blue arrow icon next to the drop-down menu. 



Comments 

Hevill] PiiblishiEd(2) 
Items per paije: 20 



^Sera* I Date posted j| .l | search 



1 2011-(H-2« 17:31:0 



tokj you Freak Fencing Accident CaiusesCaJls for Greater Safety in ^ 
sol Sport ^ 



® 
Article: 



On the right-hand side of the Comments page is an area displaying the text and metadata 
of the current comment under review, as indicated by the small yellow arrow icon in the 
comment list. 
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® New 



Approved 



Delete 



Hidden Q Ban us 



Article: Freak Fencing Accident Causes Calls for Greater Safety in Sport 

CSt Shpw article 

Dote: 2011^1 20 17:31:03 

Author: A. N. Otiier-reader <an@exaniple.com> '»' '^fe^ft^B 



Subject: 1 1 told you so! 

Comment: 

I Acorkon theendofthefDil.thafsttieonlywayto make fencing safe! 



A row of radio buttons above the comment text enable you to update the New comment's 
status to Approved, or Delete if it is spam. Alternatively, the comment can be Hidden, 
or click Ban user to the user that made the comment banned from commenting on the 
publication in future. Clicking the Show article link, next to the magnifying glass icon, 
enables you to see the comment in the context of the original article. You can also click on 
the Article name link to open the Edit article page for that particular story. 
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31. USER MANAGEMENT 

32. SUBSCRIPTIONS 
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86 



23. 



SYSTEM PREFERENCES 



The System Preferences page is accessed via Configure in the main Newscoop navigation 
menu. 




Dashboard 



Add more widgets 



Most Popular Articles 



Shewing 1 to 53 of 53 entries 



Templates 
Article Types 
Topics 
Languages 

Countries 
Localizer 
Logs 



This page allows you to control some advanced aspects of your Newscoop server, so it is 
recommended that access is reserved for administrators only. 

GENERAL SETTINGS 

The first section of the System Preferences page is for General Settings. 
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System Preferences 



General Settings 

Site On-Line: 

Site Title: 

Site Meta Keywords: 

Site Meta DescripLion: 

Time Zone: 

Database Cache Engine: 

Template Cache Handler: 

Imagecache Lifetime: 

Allow password recovery: 

Secret Key: 

Session Lifetime: 

Keyword separator: 

Number of failed login attempts before showing CAPTCHA : 

Maximum upioad file size: 

Enter a value between and 21^ [tlie maximum size is specified 
in 'php.ini). Please use K'for kilobytes. 'M'for megabytes and 'G' 
for gigabytes, wjtlioui white spaces between the value and the 
corresponding letter. e_g_ '3M'. 

SMTP Host: 
SMTP Port: 



® Yes O Mo 



TTie Custodian 



Newscoop, Scurcefebric, 



Newscoop -The open coi 



pMTnBOnj 



J 



DB 



3 



1 1 Pay jJl 

® Yes O No 






Here is what each of the options means: 

• Site On-Line: These Yes and No radio buttons enable you to put the whole 
Newscoop server on-line or off-line, for example in case of scheduled server 
maintenance 

• Site Title: The default name for your publication's website. Your designer can 
configure your publication's templates to display this information 

• Site Meta Keywords: The default keyword meta tags in your header template, for 
search engine optimization 

• Site Meta Description: The default description meta tag in your header template, 
also for search engines 

• Time Zone: This field enables you to override the server's own time zone setting, 
which is typically set to Greenwich Mean Time (GMT). You may wish for your 
Newscoop interface to display local time instead, for instance when scheduling 
publication time for a particular issue 

• Database Cache Engine: enables or disables the APC cache, which can improve 
Newscoop performance 

• Template Cache Handler: Select DB to enable the cache for templates 
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• Imagecache lifetime: The time that images will be cached for, from 30 seconds to 
infinite 

• Allow password recovery: Whether users can get a password reminder by email. 
Note that if this feature is enabled and your email account is compromised, your 
Newscoop publication can easily be compromised in turn 

• Secret Key: The security key that Newscoop can use for integration of web services 
and other advanced features 

• Session Lifetime: Enables you to specify the maximum duration of Newscoop 
administration sessions without re-authentication, which is a security feature 

• Keyword separator: Specify the separator for Keywords in the Edit Article page 
(comma or hyphen) 

• Number of failed login attempts before showing CAPTCHA: A security 
measure designed to foil password-guessing robots 

• Maximum upload file size: The maximum size of attachments that users of your 
website can upload 

• SMTP Host: The server that Newscoop will use for sending out email notifications 

• SMTP Port: The port number that Newscoop will use on the specified email server 

EDITOR SETTINGS 

The second section of the page is for Editor Settings, which refer to image handling. 



Editor Settings 



image Resizing Ratio: 100 % 



image Resizing Widtli: pixels 



image Resizing Heiglit: pixels 

ZfMm enabled for images in article content? O Yes ® Mo 



The fields in this section enable you to specify the default resize ratio, or default width and 
height, for innages in articles. If the Zoom enabled for images in article content? radio 
button is set to Yes, readers can enlarge article images in your publication's pages by clicking 
on them. 

EXTERNAL SUBSCRIPTION MANAGEMENT 

The third section down is related to external subscription management software. 



Reader subscriptions managed externally? ^Yes ® No 



If you select the Yes radio button for the Reader subscriptions managed externally? 

option, the subscription management features in the Newscoop administration interface are 
hidden. The subscription data is still held in the Newscoop database, which your systems 
administrator will have connected to your third-party subscription management software. 

DATABASE REPLICATION SERVER 

The fourth section enables you to set up Newscoop to operate on two servers at once, 
which is a safety feature in case of hardware or network problems. 
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Setting up a Newscoop Replication Server? '^ Yes W No 
Newscoop Online Server Database 
Database Replication Host; 
Database Replication User: 
Database Replication PaEEWord; 
Database Replication Port: 



db.exarnple.com 



Selecting the Yes radio button for the option Setting up a Newscoop Replication 
Server? displays four fields: 

• Database Replication Host: The name or IP address of the remote database 
server 

• Database Replication User: The user name to connect with on the remote server 

• Database Replication Password: The password to submit on the remote server 

• Database Replication Port: The port number to connect to on the remote server 
(the default port number Is 3306) 

USING AN AIRTIME MEDIA LIBRARY 

The fifth section enables you to attach media located in an Airtlme storage server to articles 
in your Newscoop publication. Once you've installed and configured Alrtime, create a user 
in the Airtlme administration interface and add it to the Admins group. Back In the 
Newscoop System Preferences page, select the Yes radio button for the option Enable 
Airtime audio attachments? 



Enable Airtlme audio attachments? 
Alrllmg Server 

Hostname ! IP At^tlress: 
Port: 

xriflL RPC Patb: 
XML RPC File: 



® Yes O No 



/airtinneJstDrage Serve 



xrLocStor.php 



Below, you should enter the host name or IP address of the Alrtime server. The values of 
the fields Port, XML RPC Path and XML RPC File should already be filled in with the default 
values. You don't need to edit these default values, unless you have a custom Airtlme 
configuration. 

The last step is to give certain users the right to attach audio files to articles. You can edit a 
Staff User Type to enable this, so that all users of this type will receive the right 
automatically. Alternatively, you can enable this right for individual staff user accounts. 
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TEMPLATES FILTER MASK 



Enter keywords for templates that you wish to hide on the Configure -> Templates page. 
For example, templates that are no longer in use, but you do not wish to delete from the 
server 



Templates filter mask (separated tjy comma) 



*,CV^ 



CRON TASKS 

Run cron tasks externally? means to use the server's own scheduler for automated 
tasks, rather than the one included in Newscoop. 







Run scheduled tasks externally? ® Yes O No 





GEOLOCATION SETTINGS 



This section enables you to specify how maps linked to articles will be displayed, and which 
Internet mapping service will provide the data. 



Geolocation Settings 

Map Center Latitude: 
Map Center Longitude: 
MapZoam Level: 
Map Default Width: 
Map Defauit Height: 



Aiiow Google Streets Map Provider 
Aiiow MapQuest Map Provider: 
Allow OpenStreet Map Provider: 
DelaiJit Map Provider: 



Map Marker Directory: 
Map Marker Defauit: 



Map Popup Minimal Width: 
Map Popup MinimaJ Height: 



□ 



[400 



m 




\ GcKM^ie streets Map It] 



^avascrlpt/geocodlng/ms 



marter-gold.png tI 



I 300 

[zoo 



VIDEO SETTINGS 
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The default width and height of both externally and locally hosted video files can be set in 
this section, to make sure that the videos are displayed correctly in your publication's page 
templates. 



Youtube Defajft Width: 
Youtube Default Hejgtit: 



s 



Vimeo Default Wliftti: 
VImeo Default Helgttt: 

Flash Default Widtli: 
Flash Default Height: 
Local Flash Server: 
Local Flash Dlractory: 



4tX) 

Z25 



H 



Finally, the Save button updates your preferences. 
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24. 



TEMPLATES 



Templates control the look and feel of your Newscoop publication. Each publication has a 
unique set of templates created by your web developer, which should have already been 
installed by your system administrator. The Newscoop administration interface includes a 
template management and editing tool, which you can find by clicking Configure on the 
main navigation menu, then Templates. 





DASHBOARD CONTEMT ^ ACTKINS ^ CONFEGURE t USERS ▼ PLUGINS ▼ 




System Preferences 

Article Types 
Topics 

Languages 
Countries 
Localizer 
Logs 






Dashboard 






Add more uvidgets 






Most Popular ftrticles 


X f 





















Templates are organized into folders, shown in a box on the left hand side of the page. 











^m 


IE 




MJ.IJIJIJIIJ,MIUJ.L1IIHi^ 


■ 


n 




ConfiaJre > Templates > Path:/ > 1 




Templates 














JActicns... _J| 1 selectAII 


1 1 Select None 












Foklers Delete 




Files Template ID Cache llfetinne, sec 


Du 


B classic S 

S system'jemplates " 


□ J get-rss.php S9i 













Clicking on the name of a folder shows the files included in that template 
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Configjre > Templates > Patti:/ classic/ 



Templates 



D Go up '#' Create newfolder + Create newtemplate D Upload template 



_tJ SelectAII SelectNone 



Folders 


Delete 


■ ess 


Q 


Bimg 


m 


■. 


□ 


Btpi 


□ 



Template [D Cache lifet]nne,.sec Duplicate 



D '_] archiv 



□ J 



article.tpj 



fe 



n _] Index.tpl 

D ._] register.tpl 

n i_] search-resulttpl 

n _] section.tpl 

□ !J topictpl 



167 
173 

172 
168 
169 
171 
170 



In turn, clicking on a file name opens that file in the template editor. This feature enables 
web developers to make quick changes to templates on a running Newscoop system. 




Configjre > Templates > Patti:! clessti > 



Edit template: article.tpl (Template ID: 173) 





Edit template: classic/article.tpl J 





Replace c 



Jg & 



J [Smertt z\[^<^ B 



1 |{ include flle^"classlc/tpl/header.tpl" }| 
2 

3 <body ld="article" class="section-{{ $giiiime->sectlor->ruiiiber }} 

4 <6iv ld="cortairer"> 

5 <ditf ld="wrapbg"> 

6 <div id="wrapper"> 
7 

3 {{ include file^"classic/tpl/headernav.tpl" }} 
9 

10 <div class="colniask rightiiienu"> 

11 <div class="colleft"> 

12 <div class="callwrap"> 

13 <div class="coll"> 



You should only make changes to the templates if you know what you are doing, because 
any modifications will have an immediate impact on the appearance of your publication. This 
feature is also useful for editing templates on a development server before they are copied 
to the publication's production server. 
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ARTICLE TYPES 



ArticleTypes specify the information that Newscoop will require from the journalists 
adding a particular kind of article to your publication. For example, a feature story is likely to 
require more elements than a brief news item. By default, Newscoop has one Article Type 
set up, which is News Article, but you can create as many as you need. To create or 
manage your Article Types, select Configure, then Article Types from the main navigation 
menu. 







^^^^^M 


DASHBOARD COWTENT - ACTTOWS - CONHGURE - USERS - FLUGIIMS - | 








System Preferences 
Templates 

Topics ^ 
Languages 
Countries 
Localizer 

Logs 




Dashboard 






Add marewjdgets 






1 MtjstPDpularArtides 


y. 1 










Showirtg 1 to 53 of 53 enitrtes 











This action opens the Article Types page. Article Types consist of a sequence of fields, with 
each field holding a certain kind of data. Currently, there are six kinds of fields available: 

• Single-line text: this type of field can contain a maximum of 265 characters, and 
does not support HTML tags. Its appearance and character set is entirely determined 
by the template in use 

• Multi-line text with WYSIWYG: this type of field can be up to 1 6MB in size. The 
journalist can insert images, audio, video, links (external, internal or to attached files), 
and formatting tags. Subheads can be used for article pagination 

• Date: this is a standard date field with a fixed syntax of YYYY-MM-DD (four year 
digits, two month digits, two day digits, separated by hyphens) 

• Topic: this type of field can be used to categorize articles. Each topic field has a top 
level element, for example Entertainment / Review. When the journalist types the 
article into Newscoop, this field will display a drop-down menu containing available 
subtopics of that top element, such as Movie Review or Theater Review 

• Switch: allows you to add check boxes which activate particular features to the Edit 
Article page. For example, you might add a switch breakingnews, which would be 
used by your template to display the article in a special place on your site. 
(Newscoop comes with two switches by default. Show article on front page and Show 
article on section page) 

• Numeric: allows you to add numeric elements to your articles, such as 
longitude/latitude, temperature, or exchange rate 

Newscoop makes a distinction between the Template Name and Display Name for 

each Article Type and field. The Template Name is limited to letters, numbers, and 
underscores (no spaces) and is used internally by your Newscoop template. The Display 
Name is the part that the journalist will see, and can be translated into other languages. 



ADDING A NEW ARTICLE TYPE 



Click the Add new article type link at the top left of the Article Types page. 
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DASHBOARD CONTENT t ACTIONS -w CONFIGURE t USERS -- PLUGINS t 




Cofifigjre > 


Article Types 






+ Add new article type ^ Merge types 


^ Show display names 




Template Type Name Ffetds Display Name 


Translate ShoiMfHMe CammentB enabled? 


news_article Fields News Article [en) 


p • • 









The Add new article type page will appear. The first step is to enter the Template Type 

Name of the Article Type you wish to create. In this example, we'll create an Article Type 
with the template type name rev/ewort/c/e - note that it has an underscore, instead of a 
space, between the words review and article. 




Configjre > Artcte Types > 



Add new article type 



Add new article ^pe 



The template name may only contain letters and the underscore (_) character. 
Template Type Name; review_article| 



After you click the Save button, you will be prompted to enter the Template Field 
Name of the first field in the new Article Type. Select one of the six field Types available 
from the drop-down menu, for example Topic. For this particular field type, we'll also have 
to select a top level element, such as Entertainment / Review. 




ConTigjre y ArticleTypes > review_artk:b > Article type fekls 



Add new field 



The template name may only contain letters arKl the jnderscore [_) character. 



Template Field Name; revlew_topic 



Type; Topic 



3 



Top element: [ Enteitainrnent/ Review 
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If you add a Multi-lineText with WYSIWYG field, you have the option to mark the field 
as content, using a checkbox. This means that each time this particular field is served by 
Newscoop, it counts as a page read for statistical purposes. 



DASHBOARD CONTENT 



ConfigjrB > ArticlB Types > [ievj5_arUcle > Article type fields 



USERS ^ PLUG INS -^ 



Add new field 



Tfie template name may only contain letters and ttie underscore (_) ctiaracter. 



Template Field Name: conclusioni 



Type: MuH-iine Textwittl WYSIWYG J 



After clicking the Save button, the Article type fields page is shown. The Article Type that 
you are currently working on is shown in the breadcrumb trail beneath the main navigation 
menu. 



DASHBOARD CONTENT 



Configjre > Article Types > revlew_article > 



CONFIGURE -^ USERS 



Article type fields 



^ Backto Article Types List 

+ Addnewfield ^^ Shaw display jiames 



Ortler Template Rekl Name Type 



Display Name Translate Is Contenrt Shoi 



Topic (Review) revievir_tcpic 



Click on the Show display names link to add a Display Name for this new field. Select 
the language you require from the Add translation drop-down menu, and enter the 
display name for the new field in this language. Then click the blue Translate button. 
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Configjre > Article Types > reviBW_artic le 



Article type fields 



^ Backto Article Types List 
+ Addn&wfield ^^ Hide display names 
Order Template Field Name Type 



D is play Name Trans late Is Cante nt Shoi 



review_topic Topic [Review) review_topic 

Afld tianslalion: Engli^ ^ Rewew Topic] 



The Article type fields page will now show the Display Name for the field, together 
with a language code (in bracl<ets) to indicate its translation. Note that the Display Name 
can contain spaces, or be capitalized differently from the Template Field Name. 



DASHBOARD CONTEIVT ^ ACTIONS ' CONFIGURE * USDIS ^ mi(»IS w 



Configjre > Article Types > revlew_art)cle 



Article type fields 



^ Backto Article Types List 

4* Addneuvfield €|^ Show display names 



Template Field Name Type 



Display Name Translate Is Content E 



Topic (Review) Review Topic (en) 



Continue to add new fields to this Article Type, until you have all that you need. Then click 
the link Back to ArticleTypes List, next to the blue arrowhead icon. This action will 
return you to the Article Types page. 

EDITING ARTICLE TYPES 

You can add translated Display Names for your new Article Type after clicking on the 
Show display names link in the ArticleTypes List. 
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^^^^^^^^^^^^^^^^^^^^^m 




JJI^I^JJIII^^ 


Configure > i 




Article Types 






4" Add newarticle type "^ Kfferge types 


^^ Hide display names 




Template Type Name Fields Display Name 


Translate ShowlHide Comments enabled? 


news article Fields NeviK Article [en) 


P • • 




en News Article 


es artkniilo 




Add translation: li^fp^ _J| 


1 1 Tr^slalE 1 




review_artlcle Fields review_aTlide 


m • • 




Add translation: | English J| 


Review ^!ulicle| ^^^^^9 


1 






1 



Article Types are not set In stone; they can evolve as your publication evolves. For example, 
you can hide old Article Types that are no longer in use. Toggle whether a type is shown by 
clicking on the colored light icon in the Show/Hide column - green for shown, red for 
hidden. A pop-up dialog will ask you if you are sure about this action. 



TJteai ifrnffs as (iei(»ie/5toi!raG-ts®qj«3(g^j®3COTa^ ss^ I§) 



J^, Are you sure you want to hide the article type 'reviewartide'? 



©Cancel 45 OK 



Hiding a type is less dangerous than deleting it; the latter action will remove the associated 
content from the server. The delete button is a white cross in a red square icon, over on 
the right side of the page. Use this button with caution! 



h- ACTIONS T CONFIGURE 



^ Merge types ^^ Show display names 



Fields Display Name Translate ShauvrHide Comments enabled? Delete 



Fields News Article [en) 
Fields review article 



m 

5J 



As usual when carrying out an action that will have an impact on your publication, 
Newscoop will ask you if you are sure. 
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^^ - . . ,. .4lllieP"J-'-'^"J'-^'"-"i^JJ^iL'"'J-'Ft- - '- ' 



Are you sure you want to delete the article type reviewartkle? 
WARNING: Deleting this article type will delete all the articles 
associated with this article type. 



Q Cancel <S9oK 



In the ArticleTypes List there is also a Comments enabled? column, which toggles 
readers comments on and off for a specific Article Type. For example, you might wish to 
disable reader comments for all entertainment reviews, but leave them enabled for news 
articles. 

Article types can be renamed, simply by clicking on the Template Type Name in the 
Article Types page. Remember that if you change a Template Type Name, you cannot put 
spaces into it. 



DASHBOARD CONTENT ^ ACTtONS ^ CONFtGURE -w USERS ^ PLUGINS t 



Cofifigjre > ArticleTypes > 



Rename article type 'reviewarticle' 



Tlie template name may only contain letters and the underscore (_) character. 
Template Type Name: reviewsLarticle 



EDITING ARTICLE TYPE FIELDS 

On the ArticleType Fields page, fields can be renamed, given Display Names, hidden or 
deleted, just like Article Types. When you have nnore than one Article Type field, you can 
re-arrange the order in which the fields show up on the Edit article page by clicking the 
blue up and down arrows. 



Configjre > ArticleTypes > review_airlic le 



Article type fields 



^ Backto ArticleTypes List 
+ Addnewfield ^^ Show dis play nam«5 
Order Template Field Name lype Display Name 



Translate Is Cant< 



W reviewjopic Topic (Review) Review Topic (en) {pj N/A 

^ ^ slnow_name Single-line Tbki Nanne of Show [en) |S N/A 

♦ star_rating Nunrveric Star rating outoffive (en) huJ N/A 
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To change a field type, for example, from Single-lineText to Multi-lineText with 
WYSIWYG, click on the corresponding link for that row in the Type column. The 
Reassign a field type page will open, on which you can select the new type from a drop- 
down menu. Then click the Save button to return to the Article type fields page. 



COHTDir w ACnOHS T CONFtGLFRE t U^^tS t PLUGIN5 ^ 




After editing article type fields, you could create a new article to test that the updated fields 
are displayed as expected. 



Conrtent > Publicatian: tlie Custodian > Issue: issuel [English) > Section: Lifestyte > Article: Movie N'gtit[ 



Movie Night 



Createfl: 2011-01-21 17:49:40 @ LastmoHWea : 2011-01-21 17:49:40 
Review Topic 



Entertainment/ Review/Movie Review 



3 



Name of Show 



B I uAffi|»»aB|ifc#«|i^xiaisi 

Hm g — A - ^ ' X. X" lia ?.;; I iE -E [ayiis 



s |"> in Ifi -■ 0- 

Forniat ^ Font famiy 



a a I a"" d.= ;^ I 'ti T,' T I asi a ■ B3 



Heniy Ptatteranti the Suitcase of Cash 



Star rating out Df five 



MERGING ARTICLE TYPES 
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Newscoop enables you to merge two different ArticleTypes so that content in fields from 
one type (the Source ArticleType) is migrated to another (the Destination Article 
Type). This is a useful process to go through after adding or editing an Article Type, so that 
all previously written copy matches the new Article Type fields. 

On the Article Types page, click the Merge types link. This opens the Merge article type 
page. Select the source and destination Article Types you wish to merge from the drop- 
down menus. 



Configure > ArticleTypes 



Merge article type 



Merge ArticleTypes: Step 1 of 3 



Source Article Type Destination Article Type 



review article 



B 



J 



Next, choose the fields of the source which you'd like to merge into fields of the 
destination. Note that you cannot merge a larger source field, such as 'Multi-line Text with 
WYSIWYG', into a smaller destination field, such as 'Single-line Text'. If this merge was 
allowed, then content from the larger field could be lost. 




Conrfigjre > ArticleTypes > 

Merge article type 



Merge Article Types: Step 2 of 3 


There are 1 articles associated w 

Source Article Tvpe 
Review Article 


th R 

-> 
-> 
-> 
-> 


''View Article that will be merged. 

Destination Article Tvpe 
News Article 

Deck 

Lead and SMS 

Bodv 


j Review Tc^c tII 


1 Name of Show _tJ| 


1 Star rating out of five tII 


1 Back to Step 1 





The next screen displays the result of the potential merge. Any source fields which have 
not been mapped to destination fields are shown in a red font. You may need to create 
additional fields in the destination Article Type before attempting the merge again. 
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You can cycle through all the articles which will be merged, and preview the changes. 
Optionally, check the box to Delete the source article type. When you're ready, click 
the Merge button. 



DASHBOARD CONTENT 



Confiojre > Article Types > 



ACTIONS T CONFIGURE ^ USERS ▼ PLUGIMS t 



Merge article type 



Merge Article Types: Step 3 of 3 



Merge configuration for merging Review Article into News Article. 

Merge review_topic into Deck 

Merge shovi(_name into Lead_and_SMS 

Merge s1ar_raljng intoi t>Ddy 

([} Cto NOT merge conclusion (No merge warning.) 

Preview a sample of the merge configuratlan. Cycle throu^gh yojranicls&tovfiniy that the merge oonfigi 

Preview of Movie Night (View the source (Review Article) version of Movie Night] lof 1. 
This is the first translation of 1 



Mame: Movie Night Created by: Daniei James 

Type: News Article Creation date: 2011-01 21 17:49:40 
Number: ^ Pul^lish date: 0000^00-00 00:00:00 



Sliow article on 
Show article on 
Allow jsers witli 



Keywords: teen, wizard, frarKhise 
Decl<:: 41 



Lead and SMS: nenry Plotter ar>d the Suitcase ol Cash 
Body: \~[^ I 



JiDelete tlie source article type (Review Article) when finished. 



Clicking -Me 



Back to Step 2 



If there are no articles left belonging to the Source Article Type, Newscoop will display a 
warning message at the first step of the proposed merge. 



DASHBOARD CONTOfT ^ ACnOHS ^ CONFIGURE ^ U^RS ^ n.UGINS ^ 



Configjre > Article Types > 



Merge article type 



Merge Article Types: Step 1 of 3 



■Rie scijfce article type [rei/iew_article) does not have any artides. 
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26. 



TOPICS 



In Newscoop, topics are the subject matters assigned by editors and journalists to articles, 
so that related articles can be Identified and displayed together. A topic can have many 
subtopics; for example: the sports topic could have the subtopics football, basketball, and 
water polo. An individual article may have several topics or subtopics assigned to it. 

To review or create topics, click Configure on the main navigation menu, then click 
Topics from the sub-menu. 




To add a new top-level topic, select a language from the drop-down menu and enter a word 
in the Add root topic field. Then click the Add button. 



DASHBOARD CONTENT ACTIONS CONFIGURE USh 



Topics 



Show languages- 



SelectAII SelectNone 



en D de D pt D fr 63 D ro D hr D cz D sh D sr D ru D sv D zh n ar D 



Search 



-^d root topic - 



[English jlpavdl 



Q en Wfeather 



l+jesTtompo 



To rename a topic, click the Edit link to the right of the topic or subtopic name. The name 
row will expand to show the Change topic name field. Update the name, and then click 
the Save button. 
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1 enlYavel 


^ Edft X 














1 BenUteather 


/■Em X 




1 Q es Tlempo 


y Edit X 














1 gen Storms 


^Edlt X 


1 


\+\ es Torrnentas 


y-Edit at 










1 


en Freak Weather 


^Edft X 














m 




1 Freaky Weather] | | 


















English! 11'^'' 




















-Sdect language- J 


1 Translale | 














|: es Lunltkw Tlempo 


/"Edit X 











You can translate topic names so that they appear in the correct language when an author is 
editing an article. To translate atopic, click the Edit link to display the Add Translation 
field for that topic name. Select the language you are translating into from the drop-down 
menu, enter the translation of the topic name, and then click the Translate button. 













ill en Travel 




• Edit X 












1 Q en Weather 




/■ Edit X 


* ■ 


















Iweatha- 


1 1 ^^ 1 


























English 1 


1 1 Add 1 






















% 




1 Deylscti 


2J|| Wetter] { |^^g 
















1 B es Tlempo 




/-Edit at 











If you translate a subtopic and its parent has not yet been translated, the parent topic will 
appear in its original language until you translate it. 

To add a subtopic, click the Edit link next to the topic you want to put the subtopic under. 
Enter a word or two into the Add Subtopic field, then click the Add button. 
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il enTlwrel 




>-Ecllt H 












1 [T] en Vfeather 




y Edit X 






















|\ftfeairier 


Save 




















t 






English JLocall | ^Q 
























-Select language- jj 


TranslatB 
















|| [TjesTleinpo 




^•Edit X 











The new subtopic will appear underneath its parent topic. 



QenUhather 



/ Edit K 



QesTleinpo 



I en Local 



Qen Storms 
gesTormentas 



/ Edit X 

^* Edit X 



I en Freaky Vtteather 



i es Lunattco Tlempo 



You can delete a specific topic or subtopic using the blue cross icon, on the right hand side 
of its row. If you attennpt to delete a topic currently in use by an article, Newscoop will 
warn you about this. 



DASHBOARD OOffTDrT t ACTHHe -r fXttnGURE ▼ USDIS ^ H-UGIMS -r 



Configjre > Topics 



Deleting topic 



TTiefe are 2 articles using the topic. 
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27. 



LANGUAGES 



While Newscoop's default language is English, you are by no means limited to publishing in 
that language only. Click Configure on the main navigation menu, then Languages from 
the submenu, to see the languages currently available on the system. 




Dcshboard 

Add more widgets 



Most Popular Artioies 



Shewing 1 to 53 of 53 entr^ 



The Language page enables you to configure support for languages that you wish to publish 
in. The Code column refers to the two-letter ISO 639- 1 code name for each language. 
English, for example, is en, German is de, Spanish is es, Russian is ru, and so on. 





^^^^^^^^H 


^^^^^^^^H 








■i 


BBBBB 


^^H 


g 


IBg^gg^B 


m 


^^^^^^B 


Configjre > 1 




Languages 

4" Add new language 




















Language 


Native name 


Code 


Delete 




English 


English 


en 


a 


German 


Deutsch 


de 


m 
m 


Portuguese 


Portugues 


French 


Fran^ais 


fr 


Spanish 


Espanol 


es 


m 
m 


Romanian 


Roimna 


ro 


Croatian 


Hrvatski 


hr 


m 


Czech 


Cesky 


cz 


m 


Serho -Croatian 
Serbian (Cyrillic) 


Srpskohrvatski 

CpncKM [TlMpH/lML^a] 


sh 
sr 


m 

m 


Russian 


PyccKi^ii 


ru 


m 


Swedish 


Svenska 


sv 


B 



Click on a name in the Language column to open a page for that language, which enables 
you to adjust month, day and time name translations. This feature ensures that automatically 
generated publication dates and times for an article in a particular language are displayed 
correctly to your international readers. 
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Corifigjre > Languages 



Edit language 



Edit langu^^ 



rJame: &eorglan| 



Mative name: [jaftmgiiiin 



Code: GE 



Please enter the translation for month names. 



January: 


nil&36ftn 






FeOruary: 


ro0b(]ft3iejin 






March: 


aafti(Jin 






April: 


ijSAntrpn 






May: 


ISf^bn 1 



To add another language, click on the Add new language link, next to the green cross 
icon. You should enter the language name (both in your own language, and the Native 
name in the language itself), and its two-letter ISO code (e.g. cy for Welsh). 



DASHBaJUm COKIBfT -r JIC^IDHS " COIFICURE - USQS " lUB 



Configjre > Languages > 



Add new language 



Add new language 



rJame: Welsh 



Mative name: Cymraeg 



Code: cy 



Please enter the translation for month names. 



January: 


1 kinawr 






FeOniary: 


Chwefror 






March: 


Mawrtti 






April: 


Ebrill 






May: 


1 Mail 1 



After entering translations in all the fields, click the Save button at the end of the page. The 
new language will now be shown on the Languages page. 
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Georgian 


d^kAmacjfl 


GE 


Q 


Chinese (Traditionai) 


S«S4^S 


zh_TW 


□ 


Polish 


Poiski 


P« 


□ 


Welsh 


Cymraeg 


^ 


m 















You may wish to limit the number of languages configured on your server, in order to spare 
your editors and journalists from having to navigate long drop-down language menus. To 
remove a language, click the white cross in a red square icon at the end of each row in the 
list. You will be asked if you are sure about this action. 



Tlfos p:>i)|w 'ift (AftOp#taKGM(M)(p=:itea3(iraf'!iFiMMSo(i(^|) •mfm [^ 



Are you sure you wart to delete the language Be/iapycKas? 



01 Cancel 43oK 



109 



28. 



COUNTRIES 



This page determines how country lists will appear in forms that readers fill in, for example 
when signing up for an email newsletter. It also enables you to create country lists in 
different languages. To see the list of country names in the default language, click Configure 
on the main navigation menu, then Countries on the submenu. 





DASHBOARD CO^TE^T ^ ACTIONS » CONFIGURE ^ USERS » PLUGINS » 




System Preferences 
Templates 
Article Types 
Topics 
Languages 

Localizer 
Logs 






Dashboard 






Add more witlgets 






Most Popular Articles 


K f 










SlKfivirig 1 to 53 o1 53 entries 





The Countries page shows an alphabetical list of countries, with the language they are 
displayed in, and a two-letter ISO 3 I 66- 1 country code for each name. Note that the 
alphabetical sorting is by the country code, rather than by the country name. 





^^^^^^H 




^H 




^^^^^^^m 


DASHBOARD CONTENT 


ACTKJNS ^ CONFIGURE 


USERS ^ 


PLUGINS ^ 




Configjre > 


Countries 




4* Add new country 










Language: 


dll Searcf, | 




1 1 2 1 3 1 4. 1 5 1 6 1 7 1 S 1 9 


10 [Next [Next 10 [Last 








Name (click to edit) 


Language Code Translate 


Delete 




Andorra 


English AD Translate 




UnitBd Arab Emirates 


English AE Translate 


Afghanistan 


English AF Translate 


m 


Antigua and Barbuda 

Anguilla 

Albania 


English AG Translate 


English Al Translate 


□ 


English AL Translate 


□ 


Armenia 
Netherlands Antilles 


English AM Translate 


□ 


English AN Translate 


□ 


Angola 
Antarctica 


English AO Translate 
Englasti AQ Translate 


□ 



Click on the name of a country to edit it, then click the Save button to return to the 
country list. 
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Configjre > Cojntries > 



Edit country name 



Edit country name 



Country: Netherlands Antilles 



Mame: Dutch Antilles| 



To translate a specific country name into a particular language, click the Translate link in 
that country's row in the list. In the Translate country name page, select the target 
language from the drop-down menu, and enter the translation into the Nanne field. Then 
click the Save button. 



CDFifigjre > CQuntrie5 



Translale country name 



Tianslate ecHintry name 

Country: Germany 



Narrie: Deutschland| 



Lotgu^e: Deu1s:j^ 



3 



To find your translated country names later, use the drop-down Language menu at the 
top of the Country page to select the language you are Interested in, and then click the 
Search button. The search results, if any, will be listed below the Search box. 



Countries 



4* Add new country 



Language: | aeutsch J| | 


Search 










Name (click to edii) Language Code 


Translate 


Delete 


Deutsctiland Deutsch DE 


Translate 


m 



III 



Newscoop's list includes almost all known countries by default, but if you have deleted a 
country and need to put it back, you can do this by clicking on the Add new country link 
next to the green cross icon. You will be prompted to enter the country's two-letter ISO 
code, name and language. The drop-down menu will contain as many languages as you have 
defined in Newscoop's Configure - Languages page. 




Conflgjre > Cojntr'es > 



Add new country 



Add new country 


Code: 

Mame: 
Language: 


@ 




Ascension teland| 








1 English 


"^ 



Note that the language you are asked to specify is the language in which you are entering a 
country's name, not the language spoken in the country. 
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29. 



THE LOCALIZER 



The default language for the Newscoop administration interface is English, but you can 
either use one of the many translations supplied with Newscoop, or create your own 
translation using the built-in Localizer tool. You can also use the Localizer to improve an 
existing translation, or adapt it for a regional dialect. 

The first step is to check that the language you wish to translate into is in the Configure 
Languages list. If your target language does not exist yet, you will have to add it to 
Newscoop first. Then, you can open the Localizer by clicking Configure, then Localizer 
on the main navigation menu. 





BASHBOARO COHIBn " ACIKINS t CONFIGURE t USERS t PLUGINS t 




System Preferences 

Templates 

Article Types 

Topics 

Languages 

Countries 

Localizer 

Logs ^ 




Dashboard 






Add more wjdgets 






Most Popular Articles 


K f 










Showing 1 to 53 of 53 entries 





The Localizer works by enabling you to translate individual 'strings' of text that appear in the 
Newscoop administration interface. There are 209 I strings in the whole of Newscoop, 
divided into 40 Screens representing the various different pages in the interface. You can 
complete a localization with a team of translators working together, by tackling one screen 
each at a time. 
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Localizer 



Translate from: 



tII I English ^ 



Espanal 



d 



Showrtranslated strings tI subnr 



en: Plugins 



trj Pluglns 
en: Manage Plugins 



Uj Admlnlstrar pluglns 
en: Account 



LrJ Cuenta 
en: Items per page 



LrJ rterrtsp 



Select your source (Translate from) and target (Translate to) languages from the drop- 
down menus, and then select a Screen, such as Geo-iocation or Article Types. Strings that 
have not yet been translated are shown in a red font. You can save your work at any time 
by clicking the disk icon next to one of the input fields. When you have completed your 
translation, there is a Save button at the end of the page. 

You will encounter strings with a dollar sign in them, e.g. "$l ". This means that one or more 
words will be substituted in place of these characters. For example, the phrase "Signed in: 
$1 ", when displayed on the interface, might be: "Signed in: Administrator". In this example, 
"Administrator" was substituted for "$ I ". 
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en: There are $1 article[3) left. 



Lrj Hay$l articulcfs) pendienlE(s) 
en: There are $1 issLies(s) left. 



^ Quedan $1 suscnpciones. 
en: There are $1 sectior^[s) left. 



y^ Hay$l seccion[es) pendiente[s} 



en: There are $1 puC]llcatlQn(E) left. 



f-^ Hay$l put]llcaclon(es} pendient>e(5} 



en: There are $1 countrl^ left. 



gg Hay$l pais[es) pendiente[s) 



TinyMCE, the WYSIWYG article editor incorporated into Newscoop, can also be localized. 
The strings in TinyMCE have to be edited nnanually by your system administrator, which is a 
task done separately from the Localizer. 

SENDING A LOCALIZATION BACK TO THE NEWSCOOP TEAM 

We actively encourage Newscoop users to send us their language localizations. This makes 
Newscoop more useful for people around the world. Even if a similar language localization 
exists, it may not address your particular needs or regional differences. For example, there 
may be differences in Spanish between that used in Spain and that used in Guatemala. In 
that case, you can localize Newscoop to your needs and share the localization with other 
users that speak your language or dialect. 

For more information on how to contribute a localization to Newscoop, please email 
contact@sourcefabric.org 
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30. 



LOGS 



The Newscoop administration interface includes a feature which enables you to keep track 
of who has done what, and when, on your publication's server. You can examine 
Newscoop's log files by clicking Configure on the main navigation menu, then Logs. 




Dashboard 

Add more wdgets 



Most Popular Articles 



SlKnving 1 to 53 of 53 enrtries 



The default log view displays all recent events on the Newscoop server, with 1 5 listings per 
page, and the most recent events first. Click the Next link or page number just above the 
search results box to see previous pages. Like most features in Newscoop, the Logs page is 
multilingual, so you may see log entries in languages other than your own. 



^H 


^^^^^^^^^^^^^^^H 


^^^^^^^^^H 


^^^^^^^^H -trill 


g 


BBBS^^^^B 


^^^ 




^^^^^^^^^^^B 


Co 


nitigjre > 








Logs 
















Event 


jJl 1 Search | 




1 1 2 1 3 M 1 5 1 6 1 7 1 a 1 9 1 10' 1 tfejtt 1 Neil 10 1 Last 




Datennme User 


Eveni 


D« script kin 


2011-01-28 13 C4S0 -- -- 
201H)1-2B 12:34:03 
2011^1-2B 12:11:00 
20114)1-2B 12:10:41 
2011-fll-2B 12;07:5« 
2D11-D1-2812£6:4D «[V w» 


Add language 


Language "Welsh" [Cymraeg) added 


Add country 


Country Ascension Island (AC) add& 


Change country name 
Change country name 


Country name Deutschland (DE) cha 
Country name Deutschlant [DE] char 


Add country 


Country Deutschland [DE] added 


Change country name 


County name Dutch Antilles [AN> ch. 



To examine the logs selectively, use the Event drop-down menu above the search results 
box to select a particular action; for example. Add country. Then click the Search button, 
and the Logs page will be refreshed to list events corresponding to that action exclusively. 
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Logs 



Event Add country 



3 



Date/Time 


User 


Description 


User IP Address 


2011-01-2B 12:341)3 
2011-01-2B 121)736 


ZiZZ 


Country Ascension feland [AC) added 
Country Deutschland (DE) added 


-••« 
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31. 



USER MANAGEMENT 



Newscoop's user management features enable you to control access for both Staff users 
and Subscribers. You can define User types for your staff members, such as Journalist or 
Editor, and manage author profiles. User management tasks have their own sub-menu on 
the main Newscoop navigation menu. 




Initially, Newscoop has only one user account: admin. Do not delete this account, as it is 
needed by the feature which informs staff users of events on the Newscoop system. The 
email address associated with the admin account is used as the "Reply-To" address in these 
notification emails. 

CREATING USER TYPES 

A User type is defined by a checklist of tasks that the user is allowed to perform in the 
Newscoop system. This list of tasks ranges from creating, managing and editing publications, 
sections, or articles, to template and plugin management. 

Instead of configuring each access right for every single user, Newscoop enables you to 
create generic user types which can be assigned to multiple users. 

Newscoop has five default user types, in order from most to least powerful: 

• Administrator - full authorization 

• Chief Editor - has the right to create and delete issues 

• Editor - limited to basic article management and editing 

• Journalist - can create articles, but not delete them 

• Subscription manager - can't change editorial content 

To create a new user type, select Staff User Types from the Users menu, then click the 
Add new user type link next to the green plus sign icon. 
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User types 



+ Addnewusertype 



Type 


Access 


Delete 


Administrator 


Change 


m 


Chief Ediffir 
Editor 


Change 
Change 




Journalist 


Change 


□ 


Subscription manager 


Change 


□ 



Name the new user type, and check the boxes for the rights that you want enabled for this 
type. Then click the Save button at the top or bottom of the list. 




Users > User types > 

Add new user type 



Add new user type 





[ 


Save 






Name: 


Subeditor 












1 Select All 


1 1 Select None | 



— Content — 

D User may addfchange pjblicayons 

D User may delete puQIicatians 

D User may add/change iEsues 

D User may delete issues 

D User may addi^change sections 

D User may delete sections 

© User may add amides 

User may criange articles 

User may move articles 

User may translate articles 

[Hj User may attach images to articl'^ 



When you return to the User types list, your new user type should be shown there. 
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User types 



+ Addneuvusertype 



TVlK 


Access 


Delete 


Administrator 


Cliange 


m 


Chief Eflitor 


Cinange 


m 


Editor 
Journalist 

Subscription manager 
Subeditor 


Change 
Cliange 




Change 
Change 


n 
u 



CREATING STAFF USERS 

To add a new Staff user, select Staff from the Users menu, and then click on the Add 
new staff member link next to the green plus sign icon. 



fSSSSSSSSSI^SS^ 


User? > 


staff management 




^ Add new staff jTiember 










FliII Name 


Accojnt Mame 


1 E-Majl 1 






Full Nam & {) Ace ount Name 


E-Mail 


User Type ■! 




Administrator admin 


suppon@sourcefabric.org 


Administrator N, 


•• 




2( 

AdTrtnistratDr 2( 



You should specify the account name, password, full name, e-mail address and phone 
number of the new user. Then choose a User type (either one of the default types, or a 
custom user type that you have created). 
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Usera > Staff 



Add new staff member 



Accojnt name: 


suziqsub 










issword Generator: 


Generate | gtEgfmvel 


Clean 








PaEEWord: 


1 ••••••••••••#•1 


7» 1 








Confirm password: 


1 




**************** 1 










Full Name: 


SuziQ. Subeditor | 






E-Mail: 


sub@example.com 








Phone: 


555 123 456 | 










Type: 


SubeOitiDr ^Jl 





Click the Show more user details link to add further information about this new user. 
Then click the Save button at the end of the page. 





Q^ Hide uEer dermis 

Title: 

Gender: 

Age: 

City: 

Street Address: 

Postal Code: 

State: 

Country: 

Fax: 

Contact Person: 

Second Pfione: 

Employer: 

Employer Type: 

Position: 








Dr. J| 

Owale ©Female 


2^39 J 




Example City 




123 Example Street 






123 ABC 




Example State 




Ascension bland 


dl 






555 123 457 | 




Mom 






555 321654J | 




The Journai 




] 


Media 




Sub Editor, Real Estate 






1 Save 1 















If you would like to fine-tune the rights assigned to this new user, follow the Click here to 
customize user permissions link on the subsequent page. 
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Users > Staff 



Change user account information 
+ Add new staff member 



Account name: 


Buziqsub 


Full Name: 


SuziQ. Subeditor 






E-Maili 


syb@example.ccim 






Phone: 


1 555 123 456 | 



^ Click hereto change password 
^ Show more jser detailB 



User Type: | Sub editQr~ 



3 



^ Click Jnere to customize user permissions 



MANAGING AUTHORS 

Newscoop includes a feature for managing author profiles, which you can find by clicking 
Manage Authors on the Users menu. Authors do not necessarily have corresponding 
login accounts on the Newscoop system, but they can still be credited as contributors to 
articles. 
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Manage Authors 



k 


Author 


Type 


Delete 


Amerigo Vespucci 


Autfior 


□ 


Daniel James 


Auttior 


□ 


Doug las Areiianes 


Autfior 


□ 


GiobaiWire Service 


Auffior 


□ 


James Q. Reporter 


Autfior 


□ 


Jane Stoclwriter 


ftUtflOf 


□ 


Jeffrey McMan us 


Auffior 


□ 


Orlando Persona 


Author 


□ 


Sarah Staffwriter 


Autfior 


□ 


Sava Tatic 


Auffior 


□ 


Stwwirtg 1 to 10 of 11 enitres 






o o 





General 



Biography 



First name: 
Last name: 
Aliases: 
Type: 



c 
c 
c 



Auft 
Writ. 
Pfio 
Edlti 
Cofi 



Contacts 

Skype: 

Jabber: 

AIM: 

Email: 



c 
c 
c 
c 



Further information can be saved for each author, using the three tabs on the right-hand 
side of the page. Multiple author types can be assigned for credits on a particular article, 
including Writer, Photographer, Editor or Columnist. The Biography tab includes afield for 
uploading an author photo, while the third tab. Content, tracks any articles associated with 
the author. 
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General Biography Content 



First name: 
Last name: 
Aliases: 
Type: 








Sarati 












StaJwriter 














II- 










Writer 
Photographer 














Contacts 

SKype: 
Jabber: 
AIM: 
Email: 








sarah,staflwriterl9B0 




































sarah@exarn.ple.oorn. 












Reset 
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32. 



SUBSCRIPTIONS 



Newscoop allows you to control reader access to your publication through its built-in 
subscription features. (If you want to have all your content freely accessible, your designer 
can bypass the subscription features in your publication's templates). Articles that you 
create in your publication are available to subscribers only by default. However, 
Administrators have the right to make a particular article accessible to non-subscribers. 

Newscoop enables you to control access to your site in two ways: 

• Account name and password pairs, which are suitable for individual users 

• IP address range access, more suitable for institutional subscribers (libraries, 
universities, NGOs, companies) 

ACCOUNT NAME AND PASSWORD ACCESS 



A non-subscriber who tries to access a subscriber-only article sees a message indicating that 
they should log in or register to see it. 



7^^ Custodian 



Home News Business Sports Lifestyle Cars Re^ Estate Blogs 



Lifestyle 



so 



Home ^ Llte'Style 



2009-03-2B 19:17:27 



The annual cat mtme festival, dogsled racing and tractor pulls top our list 

Cat Mime Festival a Major Fail, 
Organizers Say 

Sarah Staffwiitei" 

This article is locked. Please login or register to unlock it. 



The reader has the option to subscribe immediately to all articles in the same section, or the 
whole publication. This subscription can be paid or trial, depending on the reader's 
choice. 
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I 






7^^ Custodian 


M SOi 


1 Home News Business Sports Lifestyle Cars Real Estate 


Blogs 


Lifestyle 


Create or modify your profile 

Please fill in the following fomi in order to create the subscription account 




Full name: 
E-mail: 

Usemame: 
Passw^ord: 
Password (again): 
City, Country: 
Phone: 
Phone (cell): 
Type of registration: 
1 submit 1 


A.N. Other-reader 


readen^example.com 


a. n. other 






Wideawake, Ascension Isia | 


+247 123 456 7B9 


+247 123 9B7 654 | 


Paid|0| 





The list of subscribers is available in the Newscoop administration interface by clicking on 
Users in the main navigation menu, then Subscribers. 




The subscription management interface includes a search tool which enables you to list 
readers according to several criteria, including subscription expiry date. 
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Subscriber management 
"^ Add new subscriber 



FjII Mame A.N 



Account Mame other 



E-Mail example 



Subscriprtlan |e>!pires j||beltre _t]| |;0U4)3^11 | [YYYY-MM-DD) 

IP address: 1 192 . | IBl | . | | . | | (fill in from left to right at least c 



Full Name ^} Account Name E-Mail 



Subscriptions Creation Dsti 



A.N. Other-reader a.h.o1her 



reader@e5!ample.cQm Subscriptiohs 2011-02-07 17 



The duration of paid or trial subscriptions is determined by the Default time periods set 
when you created the publication. (You can change these settings for your publication by 
clicking the Configure icon in the Publication list). During a trial period, the reader has a 
chance to make payment, and consequently have their subscription extended by an 
administrator. 

The publication's administrator is automatically notified of all new subscriptions by e-mail. 
Subscribers also receive automatically generated e-mail reminders that their subscription is 
expiring two weeks before the event. The text of the subscription expiry message is 
created in a Newscoop template by your web developer. The default system template reads 
as follows: 

"Dear <reader>. 

This is an automatically generated e-mail message. Your <subs_type> subscription 

Please enter the site http : //<pub_site> to update subscription." 

IP ADDRESS ACCESS 

The IP based access feature of Newscoop can be used to automatically log in subscribers 
that have IP (Internet Protocol) addresses in a known range. This means that groups of 
readers with computers in that IP range do not need account names or passwords to 
access your subscription-only content. 

To create an IP Address subscription, go to the Subscriber management page. First, 
create a subscriber account by clicking on the Add new subscriber link, next to the green 
plus sign icon. Enter an Account name, a password, and a Full name with E-mail 
address and Phone number for the subscribing group or institution. You do not need to 
inform the readers who will be using IP address access of the existence of this Account 
name and Password. 
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User? > Subscribers > 



Adcf new subscriber 



Account name: 

Password Generator: 

Password: 

Confirm passworil: 

Full Name: 

E-Mail: 

Phone: 

^ Show more jser de 








Strang 


AN Unlversl^ Library 








1 Generate xJBSnMgv 


Clean 
am 




1 #•••••#• 1 


jm 













Q.T Librarian 




qt@example.com 








1 -Hi 234567 6910] | 


alls 



Once the new subscription account has been created, click on the Add new link in the 
User IP access list management table on the right hand side of the page. 





Subsd^tians 


+ AM rtew 


count name: AN University Library 




Fjil Name: |q.T Librarian | 


Ha subscriptions. 


U&er IP access list mainage merit 


A Add new 


E-Mail: qt@exannpie.com 




Pitane: |-h1 234 567 8910' | 


Ha recoitis. 




Click hereto change password 
Show more Jser details 


1 Saw 1 







The form allows the input of a range of consecutive IP addresses. If necessary, more ranges 
can be added later. The start IP address is the lowest address in the range, while the 
number of addresses sets the size of the range, including any address ending in zero. For 
example, if a university library had the range of IP addresses I 98.5 1 . 1 00.0 to I 98.5 I . I 00.63, 
then you would enter: 

• start IP address; I 98.5 1. 1 00.0 

• number of addresses: 64 
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Siubsci^tions 



No subscriptHns. 



User IP aoMss list management 



, Add new 



Mc lecaitis. 



start IP: 198 .51 . 100 . 


Number of addresses: 64] 




^^^^^H Cancel 



It is not necessary to add anything to the Newscoop templates for IP based subscriptions to 
work. 

It is also possible to search for subscribers based on known IP addresses. In the search box 
on the Subscriber management page, enter a number in at least one box in the field 
labeled IP address, starting on the left side. Click the Search button, and the page will 
display all subscribers that have known IP addresses which match that number (or 
numbers). 

SYNCHRONIZE NEWSCOOP AND PHORUM USERS 

This feature is found on the Users menu. It enables administrators to update the database 
of reader login accounts, so that readers can post comments in both the Newscoop 
publication and an associated Phorum bulletin board. 
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33. 



USING PLUGINS 



Plugins enable your system administrator or template designer to add functionality to your 
Newscoop installation without having to write a large amount of code. They can also enable 
you to make better use of the content and templates already in your Newscoop publication. 
Currently, there are three plugins installed by default with Newscoop: 

• Polls: A mechanism for your readers to vote on a question; the question can be set 
dynamically and can be multilingual 

• Interviews: Enables on-line interviews for your Newscoop publication; readers can 
see the latest questions and answers 

• Blogs: Enables staff members to create and post to their own blogs, including 
comments 

INSTALLING NEW PLUGINS 

Once new plugins are downloaded to your computer, they can be uploaded to your 
Newscoop server. Plugins must be uploaded to the Newscoop server in .tar archive 
format. In the Newscoop administration interface, click Plugins on the main navigation 
menu, then Manage Plugins. Click the Browse button to select the plugin from your 
computer, then click the Upload button. Once a plugin is correctly installed, you will be able 
to administer it using separate entries on the Plugins menu. 

The Manage Plugins page also provides you with a list of installed plugins. There is a check 
box which can be used to enable or disable each plugin. The white X in a red box icon 
enables you to delete a plugin from your system. 

Plugins require changes to your site's templates, but each plugin also includes sample 
templates for your designer to either copy and paste, or to use as a guide for their own 
template code. 
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34. 



WHERE TO GO FOR SUPPORT 



Sourcefabric offers full commercial support for Newscoop. Additional support is provided 
to the Newscoop user and developer community. 

Forum and mailing list: You can visit the Newscoop online support forum, and sign up 
for the mailing list, at http://f0rum.s0urcefabric.0rg/index.php/f/l 0/. 

This forum is mirrored by the mailing list, so posts on the forum appear on the mailing list 
and vice versa. You can therefore also post a message there by emailing; newscoop- 
support@lists.sourcefabric.org. 

To subscribe to forum updates via mail, please register or login to the forum by clicking the 
appropriate link. Then click the 'Subscribe' button at the top of each forum page. 

Bug reporting: Newscoop needs your input to improve. If you think you've found a bug, 
please visit http://dev.sourcefabric.org and sign in, using the same login and password that 
you registered for the Newscoop forum. Create a bug report by selecting Create Issue, 
then Newscoop, and then Bug. That way, the Newscoop team can keep track of your 
problem and notify you when it has been fixed. You can also suggest improvements and 
new features for Newscoop on that site. 

Contact: Finally, when all other avenues have been exhausted, email us directly at 
contact@sourcefabric.org and we'll try to help! 
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35. 



CREDITS 



Newscoop is being developed by an international community of developers and 
designers led by Sourcefabric. 

http://newscoop.sourcefabric.org 

Copyright® 201 I Sourcefabric o.p.s. 

Copyright ® 1 999-20 1 Media Development Loan Fund. 

LICENSE 

All chapters in this manual are licensed with the GNU General Public License version 
3. 

This documentation is free documentation; you can redistribute it and/or modify it under 
the terms of the GNU General Public License as published by the Free Software 
Foundation; either version 3 of the License, or (at your option) any later version. 

This documentation is distributed in the hope that it will be useful, but WITHOUT ANY 
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR 
A PARTICULAR PURPOSE. See the GNU General Public License for more details. 

You should have received a copy of the GNU General Public License along with this 
documentation; if not, write to the Free Software Foundation, Inc., 5 I Franklin Street, Fifth 
Floor, Boston, MA 02 1 1 0- 1 30 1 , USA. 

AUTHORS 

This manual has been edited and reworked by Daniel James, based on the collaborative 
effort at FLOSS Manuals. Thanks to all contributors! 



Q FLOSS 



Free manuals for free software 



GNU GENERAL PUBLIC LICENSE 

Version 3, 29 June 2007 

Copyright ® 2007 Free Software Foundation, Inc. <http://fsf.org/> 

Everyone is permitted to copy and distribute verbatim copies of this license document, but 
changing it is not allowed. 

Preamble 

The GNU General Public License is a free, copyleft license for software and other kinds of 
works. 
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The licenses for most software and other practical works are designed to take away your 
freedom to share and change the works. By contrast, the GNU General Public License is 
intended to guarantee your freedom to share and change all versions of a program—to make 
sure it remains free software for all its users. We, the Free Software Foundation, use the 
GNU General Public License for most of our software; it applies also to any other work 
released this way by its authors. You can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our General 
Public Licenses are designed to make sure that you have the freedom to distribute copies of 
free software (and charge for them if you wish), that you receive source code or can get it if 
you want it, that you can change the software or use pieces of it in new free programs, and 
that you know you can do these things. 

To protect your rights, we need to prevent others from denying you these rights or asking 
you to surrender the rights. Therefore, you have certain responsibilities if you distribute 
copies of the software, or if you modify it: responsibilities to respect the freedom of others. 

For example, if you distribute copies of such a program, whether gratis or for a fee, you 
must pass on to the recipients the same freedoms that you received. You must make sure 
that they, too, receive or can get the source code. And you must show them these terms 
so they know their rights. 

Developers that use the GNU GPL protect your rights with two steps: (I) assert copyright 
on the software, and (2) offer you this License giving you legal permission to copy, distribute 
and/or modify it. 

For the developers' and authors' protection, the GPL clearly explains that there is no 
warranty for this free software. For both users' and authors' sake, the GPL requires that 
modified versions be marked as changed, so that their problems will not be attributed 
erroneously to authors of previous versions. 

Some devices are designed to deny users access to install or run modified versions of the 
software inside them, although the manufacturer can do so. This is fundamentally 
incompatible with the aim of protecting users' freedom to change the software. The 
systematic pattern of such abuse occurs in the area of products for individuals to use, 
which is precisely where it is most unacceptable. Therefore, we have designed this version 
of the GPL to prohibit the practice for those products. If such problems arise substantially 
in other domains, we stand ready to extend this provision to those domains in future 
versions of the GPL, as needed to protect the freedom of users. 

Finally, every program is threatened constantly by software patents. States should not allow 
patents to restrict development and use of software on general-purpose computers, but in 
those that do, we wish to avoid the special danger that patents applied to a free program 
could make it effectively proprietary. To prevent this, the GPL assures that patents cannot 
be used to render the program non-free. 

The precise terms and conditions for copying, distribution and modification follow. 
TERMS AND CONDITIONS 
0. Definitions. 

"This License" refers to version 3 of the GNU General Public License. 

"Copyright" also means copyright-like laws that apply to other kinds of works, such as 
semiconductor masks. 
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"The Program" refers to any copyrightable work licensed under this License. Each licensee 
is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. 

To "modify" a work means to copy from or adapt all or part of the work in a fashion 
requiring copyright permission, other than the making of an exact copy. The resulting work 
is called a "modified version" of the earlier work or a work "based on" the earlier work. 

A "covered work" means either the unmodified Program or a work based on the Program. 

To "propagate" a work means to do anything with it that, without permission, would make 
you directly or secondarily liable for infringement under applicable copyright law, except 
executing it on a computer or modifying a private copy. Propagation includes copying, 
distribution (with or without modification), making available to the public, and in some 
countries other activities as well. 

To "convey" a work means any kind of propagation that enables other parties to make or 
receive copies. Mere interaction with a user through a computer network, with no transfer 
of a copy, is not conveying. 

An interactive user interface displays "Appropriate Legal Notices" to the extent that it 
includes a convenient and prominently visible feature that (I) displays an appropriate 
copyright notice, and (2) tells the user that there is no warranty for the work (except to 
the extent that warranties are provided), that licensees may convey the work under this 
License, and how to view a copy of this License. If the interface presents a list of user 
commands or options, such as a menu, a prominent item in the list meets this criterion. 

I . Source Code. 

The "source code" for a work means the preferred form of the work for making 
modifications to it. "Object code" means any non-source form of a work. 

A "Standard Interface" means an interface that either is an official standard defined by a 
recognized standards body, or, in the case of interfaces specified for a particular 
programming language, one that is widely used among developers working in that language. 

The "System Libraries" of an executable work include anything, other than the work as a 
whole, that (a) is included in the normal form of packaging a Major Component, but which is 
not part of that Major Component, and (b) serves only to enable use of the work with that 
Major Component, or to implement a Standard Interface for which an implementation is 
available to the public in source code form. A "Major Component", in this context, means a 
major essential component (kernel, window system, and so on) of the specific operating 
system (if any) on which the executable work runs, or a compiler used to produce the 
work, or an object code interpreter used to run it. 

The "Corresponding Source" for a work in object code form means all the source code 
needed to generate, install, and (for an executable work) run the object code and to modify 
the work, including scripts to control those activities. However, it does not include the 
work's System Libraries, or general-purpose tools or generally available free programs which 
are used unmodified in performing those activities but which are not part of the work. For 
example. Corresponding Source includes interface definition files associated with source 
files for the work, and the source code for shared libraries and dynamically linked 
subprograms that the work is specifically designed to require, such as by intimate data 
communication or control flow between those subprograms and other parts of the work. 

The Corresponding Source need not include anything that users can regenerate 
automatically from other parts of the Corresponding Source. 
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The Corresponding Source for a work in source code form is that same work. 

2. Basic Permissions. 

All rights granted under this License are granted for the term of copyright on the Program, 
and are irrevocable provided the stated conditions are met. This License explicitly affirms 
your unlimited permission to run the unmodified Program. The output from running a 
covered work is covered by this License only if the output, given its content, constitutes a 
covered work. This License acknowledges your rights of fair use or other equivalent, as 
provided by copyright law. 

You may make, run and propagate covered works that you do not convey, without 
conditions so long as your license otherwise remains in force. You may convey covered 
works to others for the sole purpose of having them make modifications exclusively for 
you, or provide you with facilities for running those works, provided that you comply with 
the terms of this License in conveying all material for which you do not control copyright. 
Those thus making or running the covered works for you must do so exclusively on your 
behalf, under your direction and control, on terms that prohibit them from making any 
copies of your copyrighted material outside their relationship with you. 

Conveying under any other circumstances is permitted solely under the conditions stated 
below. Sublicensing is not allowed; section 1 makes it unnecessary. 

3. Protecting Users' Legal Rights From Anti-Circumvention Law. 

No covered work shall be deemed part of an effective technological measure under any 
applicable law fulfilling obligations under article I I of the WIPO copyright treaty adopted on 
20 December I 996, or similar laws prohibiting or restricting circumvention of such 
measures. 

When you convey a covered work, you waive any legal power to forbid circumvention of 
technological measures to the extent such circumvention is effected by exercising rights 
under this License with respect to the covered work, and you disclaim any intention to limit 
operation or modification of the work as a means of enforcing, against the work's users, 
your or third parties' legal rights to forbid circumvention of technological measures. 

4. Conveying Verbatim Copies. 

You may convey verbatim copies of the Program's source code as you receive it, in any 
medium, provided that you conspicuously and appropriately publish on each copy an 
appropriate copyright notice; keep intact all notices stating that this License and any non- 
permissive terms added in accord with section 7 apply to the code; keep intact all notices of 
the absence of any warranty; and give all recipients a copy of this License along with the 
Program. 

You may charge any price or no price for each copy that you convey, and you may offer 
support or warranty protection for a fee. 

5. Conveying Modified Source Versions. 

You may convey a work based on the Program, or the modifications to produce it from the 
Program, in the form of source code under the terms of section 4, provided that you also 
meet all of these conditions: 
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• a) The work must carry prominent notices stating that you modified it, and giving a 
relevant date. 

• b) The work must carry prominent notices stating that it is released under this 
License and any conditions added under section 7. This requirement modifies the 
requirement in section 4 to "keep intact all notices". 

• c) You must license the entire work, as a whole, under this License to anyone who 
comes into possession of a copy. This License will therefore apply, along with any 
applicable section 7 additional terms, to the whole of the work, and all its parts, 
regardless of how they are packaged. This License gives no permission to license the 
work in any other way, but it does not invalidate such permission if you have 
separately received it. 

• d) If the work has interactive user interfaces, each must display Appropriate Legal 
Notices; however, if the Program has interactive interfaces that do not display 
Appropriate Legal Notices, your work need not make them do so. 

A compilation of a covered work with other separate and independent works, which are 
not by their nature extensions of the covered work, and which are not combined with it 
such as to form a larger program, in or on a volume of a storage or distribution medium, is 
called an "aggregate" if the compilation and its resulting copyright are not used to limit the 
access or legal rights of the compilation's users beyond what the individual works permit. 
Inclusion of a covered work in an aggregate does not cause this License to apply to the 
other parts of the aggregate. 

6. Conveying Non-Source Forms. 

You may convey a covered work in object code form under the terms of sections 4 and 5, 
provided that you also convey the machine-readable Corresponding Source under the 
terms of this License, in one of these ways: 

• a) Convey the object code in, or embodied in, a physical product (including a physical 
distribution medium), accompanied by the Corresponding Source fixed on a durable 
physical medium customarily used for software interchange. 

• b) Convey the object code in, or embodied in, a physical product (including a 
physical distribution medium), accompanied by a written offer, valid for at least three 
years and valid for as long as you offer spare parts or customer support for that 
product model, to give anyone who possesses the object code either ( I ) a copy of 
the Corresponding Source for all the software in the product that is covered by this 
License, on a durable physical medium customarily used for software interchange, for 
a price no more than your reasonable cost of physically performing this conveying of 
source, or (2) access to copy the Corresponding Source from a network server at 
no charge. 

• c) Convey individual copies of the object code with a copy of the written offer to 
provide the Corresponding Source. This alternative is allowed only occasionally and 
noncommercially, and only if you received the object code with such an offer, in 
accord with subsection 6b. 

• d) Convey the object code by offering access from a designated place (gratis or for a 
charge), and offer equivalent access to the Corresponding Source in the same way 
through the same place at no further charge. You need not require recipients to 
copy the Corresponding Source along with the object code. If the place to copy the 
object code is a network server, the Corresponding Source may be on a different 
server (operated by you or a third party) that supports equivalent copying facilities, 
provided you maintain clear directions next to the object code saying where to find 
the Corresponding Source. Regardless of what server hosts the Corresponding 
Source, you remain obligated to ensure that it is available for as long as needed to 
satisfy these requirements. 
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• e) Convey the object code using peer-to-peer transmission, provided you inform 
other peers vt^here the object code and Corresponding Source of the worl< are being 
offered to the general public at no charge under subsection 6d. 

A separable portion of the object code, whose source code is excluded from the 
Corresponding Source as a System Library, need not be included in conveying the object 
code work. 

A "User Product" is either ( I ) a "consumer product", which means any tangible personal 
property which is normally used for personal, family, or household purposes, or (2) 
anything designed or sold for incorporation into a dwelling. In determining whether a 
product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a 
particular product received by a particular user, "normally used" refers to atypical or 
common use of that class of product, regardless of the status of the particular user or of 
the way in which the particular user actually uses, or expects or is expected to use, the 
product. A product is a consumer product regardless of whether the product has 
substantial commercial, industrial or non-consumer uses, unless such uses represent the 
only significant mode of use of the product. 

"Installation Information" for a User Product means any methods, procedures, authorization 
keys, or other information required to install and execute modified versions of a covered 
work in that User Product from a modified version of its Corresponding Source. The 
information must suffice to ensure that the continued functioning of the modified object 
code is in no case prevented or interfered with solely because modification has been made. 

If you convey an object code work under this section in, or with, or specifically for use in, a 
User Product, and the conveying occurs as part of a transaction in which the right of 
possession and use of the User Product is transferred to the recipient in perpetuity or for a 
fixed term (regardless of how the transaction is characterized), the Corresponding Source 
conveyed under this section must be accompanied by the Installation Information. But this 
requirement does not apply if neither you nor any third party retains the ability to install 
modified object code on the User Product (for example, the work has been installed in 
ROM). 

The requirement to provide Installation Information does not include a requirement to 
continue to provide support service, warranty, or updates for a work that has been 
modified or installed by the recipient, or for the User Product in which it has been modified 
or installed. Access to a network may be denied when the modification itself materially and 
adversely affects the operation of the network or violates the rules and protocols for 
communication across the network. 

Corresponding Source conveyed, and Installation Information provided, in accord with this 
section must be in a format that is publicly documented (and with an implementation 
available to the public in source code form), and must require no special password or key 
for unpacking, reading or copying. 

7. Additional Terms. 

"Additional permissions" are terms that supplement the terms of this License by making 
exceptions from one or more of its conditions. Additional permissions that are applicable to 
the entire Program shall be treated as though they were included in this License, to the 
extent that they are valid under applicable law. If additional permissions apply only to part of 
the Program, that part may be used separately under those permissions, but the entire 
Program remains governed by this License without regard to the additional permissions. 
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When you convey a copy of a covered work, you may at your option remove any additional 
permissions from that copy, or from any part of it. (Additional permissions may be written 
to require their own removal in certain cases when you modify the work.) You may place 
additional permissions on material, added by you to a covered work, for which you have or 
can give appropriate copyright permission. 

Notwithstanding any other provision of this License, for material you add to a covered 
work, you may (if authorized by the copyright holders of that material) supplement the 
terms of this License with terms: 

• a) Disclaiming warranty or limiting liability differently from the terms of sections I 5 
and 16 of this License; or 

• b) Requiring preservation of specified reasonable legal notices or author attributions 
in that material or in the Appropriate Legal Notices displayed by works containing it; 
or 

• c) Prohibiting misrepresentation of the origin of that material, or requiring that 
modified versions of such material be marked in reasonable ways as different from 
the original version; or 

• d) Limiting the use for publicity purposes of names of licensors or authors of the 
material; or 

• e) Declining to grant rights under trademark law for use of some trade names, 
trademarks, or service marks; or 

• f) Requiring indemnification of licensors and authors of that material by anyone who 
conveys the material (or modified versions of it) with contractual assumptions of 
liability to the recipient, for any liability that these contractual assumptions directly 
impose on those licensors and authors. 

All other non-permissive additional terms are considered "further restrictions" within the 
meaning of section I 0. If the Program as you received it, or any part of it, contains a notice 
stating that it is governed by this License along with a term that is a further restriction, you 
may remove that term. If a license document contains a further restriction but permits 
relicensing or conveying under this License, you may add to a covered work material 
governed by the terms of that license document, provided that the further restriction does 
not survive such relicensing or conveying. 

If you add terms to a covered work in accord with this section, you must place, in the 
relevant source files, a statement of the additional terms that apply to those files, or a notice 
indicating where to find the applicable terms. 

Additional terms, permissive or non-permissive, may be stated in the form of a separately 
written license, or stated as exceptions; the above requirements apply either way. 

8. Termination. 

You may not propagate or modify a covered work except as expressly provided under this 
License. Any attempt otherwise to propagate or modify it is void, and will automatically 
terminate your rights under this License (including any patent licenses granted under the 
third paragraph of section I I). 

However, if you cease all violation of this License, then your license from a particular 
copyright holder is reinstated (a) provisionally, unless and until the copyright holder 
explicitly and finally terminates your license, and (b) permanently, if the copyright holder 
fails to notify you of the violation by some reasonable means prior to 60 days after the 
cessation. 
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Moreover, your license from a particular copyright holder is reinstated permanently if the 
copyright holder notifies you of the violation by some reasonable means, this is the first 
time you have received notice of violation of this License (for any work) from that copyright 
holder, and you cure the violation prior to 30 days after your receipt of the notice. 

Termination of your rights under this section does not terminate the licenses of parties 
who have received copies or rights from you under this License. If your rights have been 
terminated and not permanently reinstated, you do not qualify to receive new licenses for 
the same material under section 10. 

9. Acceptance Not Required for Having Copies. 

You are not required to accept this License in order to receive or run a copy of the 
Program. Ancillary propagation of a covered work occurring solely as a consequence of 
using peer-to-peer transmission to receive a copy likewise does not require acceptance. 
However, nothing other than this License grants you permission to propagate or modify any 
covered work. These actions infringe copyright if you do not accept this License. Therefore, 
by modifying or propagating a covered work, you indicate your acceptance of this License to 
do so. 

10. Automatic Licensing of Downstream Recipients. 

Each time you convey a covered work, the recipient automatically receives a license from 
the original licensors, to run, modify and propagate that work, subject to this License. You 
are not responsible for enforcing compliance by third parties with this License. 

An "entity transaction" is a transaction transferring control of an organization, or 
substantially all assets of one, or subdividing an organization, or merging organizations. If 
propagation of a covered work results from an entity transaction, each party to that 
transaction who receives a copy of the work also receives whatever licenses to the work 
the party's predecessor in interest had or could give under the previous paragraph, plus a 
right to possession of the Corresponding Source of the work from the predecessor in 
interest, if the predecessor has it or can get it with reasonable efforts. 

You may not impose any further restrictions on the exercise of the rights granted or 
affirmed under this License. For example, you may not impose a license fee, royalty, or 
other charge for exercise of rights granted under this License, and you may not initiate 
litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is 
infringed by making, using, selling, offering for sale, or importing the Program or any portion 
of it. 

I I . Patents. 

A "contributor" is a copyright holder who authorizes use under this License of the Program 
or a work on which the Program is based. The work thus licensed is called the contributor's 
"contributor version". 

A contributor's "essential patent claims" are all patent claims owned or controlled by the 
contributor, whether already acquired or hereafter acquired, that would be infringed by 
some manner, permitted by this License, of making, using, or selling its contributor version, 
but do not include claims that would be infringed only as a consequence of further 
modification of the contributor version. For purposes of this definition, "control" includes 
the right to grant patent sublicenses in a manner consistent with the requirements of this 
License. 
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Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under 
the contributor's essential patent claims, to make, use, sell, offer for sale, import and 
otherwise run, modify and propagate the contents of its contributor version. 

In the following three paragraphs, a "patent license" is any express agreement or 
commitment, however denominated, not to enforce a patent (such as an express 
permission to practice a patent or covenant not to sue for patent infringement). To "grant" 
such a patent license to a party means to make such an agreement or commitment not to 
enforce a patent against the party. 

If you convey a covered work, knowingly relying on a patent license, and the Corresponding 
Source of the work is not available for anyone to copy, free of charge and under the terms 
of this License, through a publicly available network server or other readily accessible 
means, then you must either ( I ) cause the Corresponding Source to be so available, or (2) 
arrange to deprive yourself of the benefit of the patent license for this particular work, or 
(3) arrange, in a manner consistent with the requirements of this License, to extend the 
patent license to downstream recipients. "Knowingly relying" means you have actual 
knowledge that, but for the patent license, your conveying the covered work in a country, 
or your recipient's use of the covered work in a country, would infringe one or more 
identifiable patents in that country that you have reason to believe are valid. 

If, pursuant to or in connection with a single transaction or arrangement, you convey, or 
propagate by procuring conveyance of, a covered work, and grant a patent license to some 
of the parties receiving the covered work authorizing them to use, propagate, modify or 
convey a specific copy of the covered work, then the patent license you grant is 
automatically extended to all recipients of the covered work and works based on it. 

A patent license is "discriminatory" if it does not include within the scope of its coverage, 
prohibits the exercise of, or is conditioned on the non-exercise of one or more of the 
rights that are specifically granted under this License. You may not convey a covered work if 
you are a party to an arrangement with a third party that is in the business of distributing 
software, under which you make payment to the third party based on the extent of your 
activity of conveying the work, and under which the third party grants, to any of the parties 
who would receive the covered work from you, a discriminatory patent license (a) in 
connection with copies of the covered work conveyed by you (or copies made from those 
copies), or (b) primarily for and in connection with specific products or compilations that 
contain the covered work, unless you entered into that arrangement, or that patent license 
was granted, prior to 28 March 2007. 

Nothing in this License shall be construed as excluding or limiting any implied license or 
other defenses to infringement that may otherwise be available to you under applicable 
patent law. 

12. No Surrender of Others' Freedom. 

If conditions are imposed on you (whether by court order, agreement or otherwise) that 
contradict the conditions of this License, they do not excuse you from the conditions of 
this License. If you cannot convey a covered work so as to satisfy simultaneously your 
obligations under this License and any other pertinent obligations, then as a consequence 
you may not convey it at all. For example, if you agree to terms that obligate you to collect a 
royalty for further conveying from those to whom you convey the Program, the only way 
you could satisfy both those terms and this License would be to refrain entirely from 
conveying the Program. 

I 3. Use with the GNU Affero General Public License. 
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Notwithstanding any other provision of this License, you have permission to link or 
combine any covered work with a work licensed under version 3 of the GNU Affero 
General Public License into a single combined work, and to convey the resulting work. The 
terms of this License will continue to apply to the part which is the covered work, but the 
special requirements of the GNU Affero General Public License, section 13, concerning 
interaction through a network will apply to the combination as such. 

14. Revised Versions of this License. 

The Free Software Foundation may publish revised and/or new versions of the GNU 
General Public License from time to time. Such new versions will be similar in spirit to the 
present version, but may differ in detail to address new problems or concerns. 

Each version is given a distinguishing version number. If the Program specifies that a certain 
numbered version of the GNU General Public License "or any later version" applies to it, 
you have the option of following the terms and conditions either of that numbered version 
or of any later version published by the Free Software Foundation. If the Program does not 
specify a version number of the GNU General Public License, you may choose any version 
ever published by the Free Software Foundation. 

If the Program specifies that a proxy can decide which future versions of the GNU General 
Public License can be used, that proxy's public statement of acceptance of a version 
permanently authorizes you to choose that version for the Program. 

Later license versions may give you additional or different permissions. However, no 
additional obligations are imposed on any author or copyright holder as a result of your 
choosing to follow a later version. 

15. Disclaimer of Warranty. 

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY 
APPUCABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE 
COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" 
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK 
AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. 
SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL 
NECESSARY SERVICING, REPAIR OR CORRECTION. 

16. Limitation of Liability. 

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN 
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO 
MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO 
YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR 
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE 
PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING 
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A 
FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF 
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF 
SUCH DAMAGES. 

17. Interpretation of Sections 15 and 16. 
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